plugins/org.eclipse.epf.help.doc/html/guidance.html - gerrit/epf/org.eclipse.epf.archive - Git at Google

 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE html
   PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html lang="en-us" xml:lang="en-us">
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <meta name="copyright" content="(C) Copyright Eclipse contributors 2005, 2006" />
 <meta name="DC.rights.owner" content="(C) Copyright Eclipse contributors 2005, 2006" />
 <meta name="security" content="public" />
 <meta name="Robots" content="index,follow" />
 <meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
 <meta name="DC.Type" content="concept" />
 <meta name="DC.Title" content="Guidance" />
 <meta name="DC.Relation" scheme="URI" content="createguidance.html#createguidance" />
 <meta name="DC.Format" content="XHTML" />
 <meta name="DC.Identifier" content="guidance" />
 <meta name="DC.Language" content="en-us" />
 <!--
     Copyright (c) 2005, 2006 IBM Corporation and others.
     All rights reserved. This program and the accompanying materials
     are made available under the terms of the Eclipse Public License v1.0
     which accompanies this distribution, and is available at
     http://www.eclipse.org/legal/epl-v10.html
     Contributors:
     IBM Corporation - initial implementation
 -->
 <link rel="stylesheet" type="text/css" href="./ibmdita.css" />
 <title>Guidance</title>
 </head>
 <body id="guidance"><a name="guidance"><!-- --></a>

 <h1 class="topictitle1">Guidance</h1>
 <div><div class="p">Guidance is a general term for additional information related to <a href="role.html#role">roles</a>, <a href="task.html#task">tasks</a>, and <a href="workproduct.html#workproduct">work products</a>. Examples of guidance are:<ul><li><strong><span class="keyword">Guideline</span></strong> - Provides additional detail on how
 to perform a particular task or grouping of tasks, or that provides additional
 detail, rules, and recommendations on work products and their properties.
 Amongst others, it can include details about best practices and different
 approaches for doing work, how to use particular types of work products, information
 on different subtypes and variants of the work product and how they evolve
 throughout a lifecycle, discussions on skills the performing roles should
 acquire or improve upon, and measurements for progress and maturity.<p></p>
 </li>
 <li><strong><span class="keyword">Template</span></strong> - A specific type of guidance that
 provides for a work product a predefined table of contents, sections, packages,
 and/or headings, a standardized format, as well as descriptions how the sections
 and packages are supposed to be used and completed. Templates cannot only
 be provided for documents, but also for conceptual models or physical data
 stores.<p></p>
 </li>
 <li><strong><span class="keyword">Checklist</span></strong> - A specific type of guidance that
 identifies a series of items that need to be completed or verified. Checklists
 are often used in reviews such as walkthroughs or inspections.<p></p>
 </li>
 <li><strong><span class="keyword">Tool Mentor</span></strong> - A specific type of guidance that
 shows how to use a specific tool to accomplish some piece of work, either
 in the context of, or independent from, a task or activity.<p></p>
 </li>
 <li><strong><span class="keyword">Supporting Material</span></strong> - Used as a catch all for
 other types of guidance not specifically defined elsewhere. It can be related
 to all kinds of content elements, including other guidance elements.<p></p>
 </li>
 <li><strong><span class="keyword">Report</span></strong> - A predefined template of a result that
 is generated on the basis of other work products as an output from some form
 of tool automation. An example for a report would be a use case model survey,
 which is generated by extracting diagram information from a graphical model
 and textual information from documents and combines these two types of information
 into a report.<p></p>
 </li>
 <li><strong><span class="keyword">Concept</span></strong> - A specific type of guidance that outlines
 key ideas associated with basic principles underlying the referenced item.
 Concepts normally address more general topics than guidelines and span across
 several work product and/or tasks or activities.<p></p>
 </li>
 <li><strong><span class="keyword">Practice</span></strong> - Represents a proven way or strategy
 of doing work to achieve a goal that has a positive impact on work product
 or process quality. Practices are defined orthogonal to methods and processes.
 They could summarize aspects that impact may different parts of a method or
 specific process. <p></p>
 </li>
 <li><strong><span class="keyword">Reusable Asset</span></strong> - Provides a solution to a problem
 for a given context. The asset may have a variability point, which is a location
 in the asset that may have a value provided or customized by the asset consumer.
 The asset has rules for usage which are the instructions describing how the
 asset should be used.<p></p>
 </li>
 <li><strong><span class="keyword">Term Definition</span></strong> - Defines concepts and is used
 to build up the Glossary. A term definition is not directly related to content
 elements, but its relationship is being derived when the term is used in the
 content elements description text.<p></p>
 </li>
 <li><strong><span class="keyword">White Paper</span></strong> - A special concept guidance that
 has been external reviewed or published and can be read and understood in
 isolation of other content elements and guidance.<p></p>
 </li>
 <li><strong><span class="keyword">Example</span></strong> - A specific type of guidance that provides
 an example of a completed work product.</li>
 </ul>
 See also:</div>
 </div>
 <div><div class="reltasks"><strong>Related tasks</strong><br />
 <div><a href="createguidance.html#createguidance">Create Guidance</a></div>
 </div>
 </div>
 </body>
 </html>
	<?xml version="1.0" encoding="UTF-8"?>
	<!DOCTYPE html
	PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
	<html lang="en-us" xml:lang="en-us">
	<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
	<meta name="copyright" content="(C) Copyright Eclipse contributors 2005, 2006" />
	<meta name="DC.rights.owner" content="(C) Copyright Eclipse contributors 2005, 2006" />
	<meta name="security" content="public" />
	<meta name="Robots" content="index,follow" />
	<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
	<meta name="DC.Type" content="concept" />
	<meta name="DC.Title" content="Guidance" />
	<meta name="DC.Relation" scheme="URI" content="createguidance.html#createguidance" />
	<meta name="DC.Format" content="XHTML" />
	<meta name="DC.Identifier" content="guidance" />
	<meta name="DC.Language" content="en-us" />
	<!--
	Copyright (c) 2005, 2006 IBM Corporation and others.
	All rights reserved. This program and the accompanying materials
	are made available under the terms of the Eclipse Public License v1.0
	which accompanies this distribution, and is available at
	http://www.eclipse.org/legal/epl-v10.html
	Contributors:
	IBM Corporation - initial implementation
	-->
	<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
	<title>Guidance</title>
	</head>
	<body id="guidance"><a name="guidance"><!-- --></a>

	<h1 class="topictitle1">Guidance</h1>
	<div><div class="p">Guidance is a general term for additional information related to <a href="role.html#role">roles</a>, <a href="task.html#task">tasks</a>, and <a href="workproduct.html#workproduct">work products</a>. Examples of guidance are:<ul><li><strong><span class="keyword">Guideline</span></strong> - Provides additional detail on how
	to perform a particular task or grouping of tasks, or that provides additional
	detail, rules, and recommendations on work products and their properties.
	Amongst others, it can include details about best practices and different
	approaches for doing work, how to use particular types of work products, information
	on different subtypes and variants of the work product and how they evolve
	throughout a lifecycle, discussions on skills the performing roles should
	acquire or improve upon, and measurements for progress and maturity.<p></p>
	</li>
	<li><strong><span class="keyword">Template</span></strong> - A specific type of guidance that
	provides for a work product a predefined table of contents, sections, packages,
	and/or headings, a standardized format, as well as descriptions how the sections
	and packages are supposed to be used and completed. Templates cannot only
	be provided for documents, but also for conceptual models or physical data
	stores.<p></p>
	</li>
	<li><strong><span class="keyword">Checklist</span></strong> - A specific type of guidance that
	identifies a series of items that need to be completed or verified. Checklists
	are often used in reviews such as walkthroughs or inspections.<p></p>
	</li>
	<li><strong><span class="keyword">Tool Mentor</span></strong> - A specific type of guidance that
	shows how to use a specific tool to accomplish some piece of work, either
	in the context of, or independent from, a task or activity.<p></p>
	</li>
	<li><strong><span class="keyword">Supporting Material</span></strong> - Used as a catch all for
	other types of guidance not specifically defined elsewhere. It can be related
	to all kinds of content elements, including other guidance elements.<p></p>
	</li>
	<li><strong><span class="keyword">Report</span></strong> - A predefined template of a result that
	is generated on the basis of other work products as an output from some form
	of tool automation. An example for a report would be a use case model survey,
	which is generated by extracting diagram information from a graphical model
	and textual information from documents and combines these two types of information
	into a report.<p></p>
	</li>
	<li><strong><span class="keyword">Concept</span></strong> - A specific type of guidance that outlines
	key ideas associated with basic principles underlying the referenced item.
	Concepts normally address more general topics than guidelines and span across
	several work product and/or tasks or activities.<p></p>
	</li>
	<li><strong><span class="keyword">Practice</span></strong> - Represents a proven way or strategy
	of doing work to achieve a goal that has a positive impact on work product
	or process quality. Practices are defined orthogonal to methods and processes.
	They could summarize aspects that impact may different parts of a method or
	specific process. <p></p>
	</li>
	<li><strong><span class="keyword">Reusable Asset</span></strong> - Provides a solution to a problem
	for a given context. The asset may have a variability point, which is a location
	in the asset that may have a value provided or customized by the asset consumer.
	The asset has rules for usage which are the instructions describing how the
	asset should be used.<p></p>
	</li>
	<li><strong><span class="keyword">Term Definition</span></strong> - Defines concepts and is used
	to build up the Glossary. A term definition is not directly related to content
	elements, but its relationship is being derived when the term is used in the
	content elements description text.<p></p>
	</li>
	<li><strong><span class="keyword">White Paper</span></strong> - A special concept guidance that
	has been external reviewed or published and can be read and understood in
	isolation of other content elements and guidance.<p></p>
	</li>
	<li><strong><span class="keyword">Example</span></strong> - A specific type of guidance that provides
	an example of a completed work product.</li>
	</ul>
	See also:</div>
	</div>
	<div><div class="reltasks"><strong>Related tasks</strong><br />
	<div><a href="createguidance.html#createguidance">Create Guidance</a></div>
	</div>
	</div>
	</body>
	</html>