blob: c778104fe2aae2666c2912b086998522ab1338ab [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<org.eclipse.epf.uma:TaskDescription xmi:version="2.0"
xmlns:xmi="http://www.omg.org/XMI" xmlns:org.eclipse.epf.uma="http://www.eclipse.org/epf/uma/1.0.4/uma.ecore"
xmlns:rmc="http://www.ibm.com/rmc" rmc:version="7.2.0" xmlns:epf="http://www.eclipse.org/epf"
epf:version="1.2.0" xmi:id="_Nqwi8KeqEdmKDbQuyzCoqQ"
name="detail_requirements,_0e1mIMlgEdmt3adZL5Dmdw" guid="_Nqwi8KeqEdmKDbQuyzCoqQ"
changeDate="2006-09-29T15:31:25.226-0700" version="1.0.0">
<sections xmi:id="_vWeHMCxSEdqjsdw1QLH_6Q" name="Detail Use Cases and Scenarios"
guid="_vWeHMCxSEdqjsdw1QLH_6Q">
<sectionDescription>&lt;p>&#xD;
Some &lt;a class=&quot;elementLink&quot; href=&quot;./../../core.tech.common.base/workproducts/use_case_22BE66E2.html&quot;&#xD;
guid=&quot;_0VGbUMlgEdmt3adZL5Dmdw&quot;>***Use Case&lt;/a>s and scenarios may need to be described in more detail to validate our&#xD;
understanding of the requirement and to permit software development to begin. This does not imply that all&amp;nbsp;use&#xD;
cases and scenarios will be detailed prior to commencing implementation. Collaborate with stakeholders to detail only&#xD;
those that are prioritized for implementation in the next iteration or two (see &lt;a class=&quot;elementLinkWithType&quot;&#xD;
href=&quot;./../../opn.swd.prac.legacy_pm/workproducts/iteration_plan_B46FED39.html&quot;&#xD;
guid=&quot;_0aQBEslgEdmt3adZL5Dmdw&quot;>Artifact: Iteration Plan&lt;/a>), or those that are deemed architecturally significant (see&#xD;
&lt;a class=&quot;elementLinkWithType&quot;&#xD;
href=&quot;./../../core.tech.slot.base/guidances/concepts/architecturally_significant_requirements_1EE5D757.html&quot;&#xD;
guid=&quot;_HrZGIA4MEduibvKwrGxWxA&quot;>Concept: Architecturally Significant Requirements&lt;/a>).&#xD;
&lt;/p>&#xD;
&lt;p>&#xD;
The level of detail captured will vary depending upon the needs of the project and the complexity of the use case. For&#xD;
a discussion of the different levels of detail that may be applicable see &lt;a class=&quot;elementLinkWithType&quot;&#xD;
href=&quot;./../../opn.tech.prac.rqmts_with_use_cases/guidances/guidelines/use_case_formats_FF4AE425.html&quot;&#xD;
guid=&quot;_qq0GMAXkEduj_7BEUj1JfQ&quot;>Guideline: *Use Case Formats&lt;/a>.&#xD;
&lt;/p>&#xD;
&lt;p>&#xD;
Capture the use-case details in &lt;a class=&quot;elementLinkWithType&quot;&#xD;
href=&quot;./../../core.tech.common.base/workproducts/use_case_22BE66E2.html&quot; guid=&quot;_0VGbUMlgEdmt3adZL5Dmdw&quot;>Artifact:&#xD;
***Use Case&lt;/a>. For additional information on detailing use cases and scenarios, see &lt;a class=&quot;elementLinkWithType&quot;&#xD;
href=&quot;./../../opn.tech.prac.rqmts_with_use_cases/guidances/guidelines/detail_ucs_and_scenarios_6BC56BB7.html&quot;&#xD;
guid=&quot;_4BJ_YCxSEdqjsdw1QLH_6Q&quot;>Guideline: ***Detail Use Cases and Scenarios&lt;/a>. For assistance in assessing the&#xD;
quality of the use cases see &lt;a class=&quot;elementLinkWithType&quot;&#xD;
href=&quot;./../../opn.tech.prac.rqmts_with_use_cases/guidances/checklists/use_case_C5362874.html&quot;&#xD;
guid=&quot;_0kNwINk1Edq2Q8qZoWbvGA&quot;>Checklist: *Use Case&lt;/a>.&#xD;
&lt;/p></sectionDescription>
</sections>
<sections xmi:id="_B47VwCxTEdqjsdw1QLH_6Q" name="Detail System-Wide Requirements "
guid="_B47VwCxTEdqjsdw1QLH_6Q">
<sectionDescription>&lt;p>&#xD;
Some &lt;a class=&quot;elementLink&quot; href=&quot;./../../core.tech.common.base/workproducts/system_wide_requirements_7D9DD47C.html&quot;&#xD;
guid=&quot;_BVh9cL-CEdqb7N6KIeDL8Q&quot;>** System-Wide Requirements&lt;/a> may need to be clarified or described in more detail,&#xD;
new requirements&amp;nbsp;may have been discovered as we detailed the use cases and scenarios, and new requirements may&#xD;
have been submitted as &lt;a class=&quot;elementLink&quot;&#xD;
href=&quot;./../../opn.swd.prac.legacy_pm/guidances/concepts/change_requests_AD4868FE.html&quot;&#xD;
guid=&quot;_6jdvECb3Edqh1LYUOGRh2A&quot;>Change Requests&lt;/a>. Collaborate with stakeholders to capture, refine and validate those&#xD;
requirements that will have an impact on near term work (see &lt;a class=&quot;elementLinkWithType&quot;&#xD;
href=&quot;./../../opn.swd.prac.legacy_pm/workproducts/iteration_plan_B46FED39.html&quot;&#xD;
guid=&quot;_0aQBEslgEdmt3adZL5Dmdw&quot;>Artifact: Iteration Plan&lt;/a>) or are deemed architecturally significant (see &lt;a&#xD;
class=&quot;elementLinkWithType&quot;&#xD;
href=&quot;./../../core.tech.slot.base/guidances/concepts/architecturally_significant_requirements_1EE5D757.html&quot;&#xD;
guid=&quot;_HrZGIA4MEduibvKwrGxWxA&quot;>Concept: Architecturally Significant Requirements&lt;/a>).&#xD;
&lt;/p>&#xD;
&lt;p>&#xD;
Capture these requirements in the &lt;a class=&quot;elementLinkWithType&quot;&#xD;
href=&quot;./../../core.tech.common.base/workproducts/system_wide_requirements_7D9DD47C.html&quot;&#xD;
guid=&quot;_BVh9cL-CEdqb7N6KIeDL8Q&quot;>Artifact: ** System-Wide Requirements&lt;/a>.&amp;nbsp; For additional guidance on detailing&#xD;
supporting requirements see &lt;a class=&quot;elementLinkWithType&quot;&#xD;
href=&quot;./../../opn.tech.prac.rqmts_with_use_cases/guidances/guidelines/system_wide_requirements_8ED0BB6B.html&quot;&#xD;
guid=&quot;_wr24gNcGEdqz_d2XWoVt6Q&quot;>Guideline: *System-Wide Requirements&lt;/a>. For assistance in assessing the quality of&#xD;
your supporting requirements see &lt;a class=&quot;elementLinkWithType&quot;&#xD;
href=&quot;./../../core.tech.slot.base/guidances/checklists/non_functional_or_system_wide_requirements_renamed_3158BF2F.html&quot;&#xD;
guid=&quot;_Vael8CGMEdu3VKXZx45D3A&quot;>Checklist: *Non-Functional or System-Wide Requirements&lt;/a>.&#xD;
&lt;/p></sectionDescription>
</sections>
<sections xmi:id="_2389cOz2Edq2wJOsmRwmhg" name="Detail Glossary terms" guid="_2389cOz2Edq2wJOsmRwmhg">
<sectionDescription>Review the flow of the use case or scenario. If information is exchanged, be specific about what is passed back and forth.&#xD;
Collaborate with stakeholders to ensure that you define newly discovered domain terms, or ambiguous terms properly in the&#xD;
&lt;a class=&quot;elementLink&quot; href=&quot;./../../core.gen.common.base/workproducts/glossary_5D300778.html&quot;&#xD;
guid=&quot;_Wn7HcNcEEdqz_d2XWoVt6Q&quot;>*Glossary&lt;/a>. If your understanding of the domain has improved, refine existing glossary&#xD;
terms.</sectionDescription>
</sections>
<sections xmi:id="_BYbboN-bEdqiM_wFaqLjNg" name="Achieve concurrence" guid="_BYbboN-bEdqiM_wFaqLjNg">
<sectionDescription>&lt;p>&#xD;
Conduct a review&amp;nbsp;of the&amp;nbsp;requirements (&lt;a class=&quot;elementLinkWithType&quot;&#xD;
href=&quot;./../../core.tech.common.base/workproducts/use_case_22BE66E2.html&quot; guid=&quot;_0VGbUMlgEdmt3adZL5Dmdw&quot;>Artifact:&#xD;
***Use Case&lt;/a> and &lt;a class=&quot;elementLinkWithType&quot;&#xD;
href=&quot;./../../core.tech.common.base/workproducts/system_wide_requirements_7D9DD47C.html&quot;&#xD;
guid=&quot;_BVh9cL-CEdqb7N6KIeDL8Q&quot;>Artifact: ** System-Wide Requirements&lt;/a>)&amp;nbsp;with relevant&amp;nbsp;&lt;a&#xD;
class=&quot;elementLinkWithUserText&quot; href=&quot;./../../opn.tech.roles.openup_role_defs/roles/stakeholder_9FFD4106.html&quot;&#xD;
guid=&quot;_dTa6gMAYEdqX-s4mWhkyqQ&quot;>Stakeholders&lt;/a> and the development team to ensure consistency with the &lt;a&#xD;
class=&quot;elementLink&quot; href=&quot;./../../core.tech.common.base/workproducts/vision_2E71B03C.html&quot;&#xD;
guid=&quot;_0WVxcMlgEdmt3adZL5Dmdw&quot;>** Vision&lt;/a>, assess quality, and identify required changes. See&amp;nbsp;&lt;a&#xD;
class=&quot;elementLinkWithType&quot;&#xD;
href=&quot;./../../opn.tech.prac.basic_tech_rqmts_def/guidances/guidelines/effective_req_reviews_5913D369.html&quot;&#xD;
guid=&quot;_E-dPIL-GEdqb7N6KIeDL8Q&quot;>Guideline: *Effective Requirement Reviews&lt;/a>&amp;nbsp;for more information.&#xD;
&lt;/p></sectionDescription>
</sections>
<keyConsiderations>To avoid unnecessary rework, only those requirements that are scheduled for implementation in the near term (in the next&#xD;
iteration or two) should be detailed.</keyConsiderations>
<purpose>The purpose of this task is to describe one or more requirements in sufficient detail to validate understanding of the&#xD;
requirement, to ensure concurrence with stakeholder expectations, and to permit software development to begin.</purpose>
</org.eclipse.epf.uma:TaskDescription>