This is an example of what a development case may look like. There is no point
in restating information already in the process. What you have to describe are
the deviations from the
process. You may put together a Development Case
that contains a small description of the process. However, the problem with that kind of
document is that they tend to grow forever, until they're the size of
the process handbook!
This example is intended to give you an idea about how a development case would look
for a small project, let's say a commercial information system.
For more information about the Development Case, its contents, and outline, see Artifact: Development Case.
Date |
Version |
Description |
Author |
---|---|---|---|
01/01/2000 |
1.0 | - | Tom Smith |
The purpose of the document is to describe the development process for the project ABC.
Not applicable.
Not applicable.
See the section titled "Project Plan" in the project's Software Development Plan.
The development-case example presented here takes you through all nine disciplines: Business Modeling, Requirements, Analysis & Design, Implementation, Test, Deployment, Configuration & Change Management, Project Management, and Environment.
The purpose of this section is to explain how the discipline configuration works. This includes the purpose of the different tables and sections that describe each activity in the section titled "Activities".
This section details any changes made to the structure of the activity itself. Typical changes include the addition of tasks to describe company-specific ways of working or the removal of tasks from the activity.
The section describes, in a table, how the work product will be used. Additional 'local' work products can be added to the table as needed.
Work Products | How to use | Review Details | Tools used | Templates/ Examples |
|||
---|---|---|---|---|---|---|---|
Incep | Elab | Const | Trans | ||||
Column Name | Purpose | Contents/Comments |
---|---|---|
Work Products | To name of the work product | A reference to the work product in the Rational Unified Process (RUP) or to a local work product definition that's held as part of the development case. |
How to use | To qualify how the work product is used across the life cycle | For each phase, decide on:
These are defined in the Guidelines: Classifying Work Products . |
Review Details | To define the review level and review procedures applied to the work product. | Decide on the review level:
Additional information: Guidelines: Review Levels . Also add a reference to the definition and detail of the relevant review procedures. The reference could point to either the RUP or to the section titled "Review Procedure" in the development case. More specific review procedures are defined in the discipline's "Additional Review Procedures" sub-section. |
Tools used | To define the tool or tools used to produce the work product. | References to the details of the tools used to develop and maintain the work product. |
Templates/Examples | To provide the templates to be used and examples of work product that use the templates. | References to templates and examples. This could refer to either the templates and examples in the RUP or local templates and examples. This column may also contain references to actual work product that provide additional help to project members. |
This section has three main purposes:
Work Products | How to Use | Reason |
---|---|---|
|
|
This section lists the reports to be used and additional 'local' reports can be added to the table as needed.
Reports | How to use | Templates/Examples | Tools Used |
---|---|---|---|
|
|
This section has two main purposes. First, it lists all reports that the project has decided it Won't use, and the motives behind its decision not to use them. Secondly, if the development case is a an organization-level use case, this is where to add notes on what each project needs to consider when they decide what to do with the report.
This section captures any additional review procedures required for the work products used in the discipline. These supplement the general review procedures described in the "Overview" section of the Development Case.
This section captures any outstanding issues with the discipline's configuration. This section can be used as an Issues List while building the development case.
A work product is an artifact, outcome, or deliverable of the process. It is often developed within one discipline, although there are exceptions. Work products are organized in the discipline where it's created. To describe how a work product will be used, consider the following classification scheme and see Guidelines: Classifying Work Products
The project uses the following review levels:
Additional information: Guidelines: Review Levels .
To be defined later in the project.
To be defined later in the project.
To be defined later in the project.
No changes. For details see the Requirements Overview .
Work Products | How to use | Review Details | Tools used | Templates/ Examples |
|||
---|---|---|---|---|---|---|---|
Incep | Elab | Const | Trans | ||||
Actor |
Must |
Must |
Must |
Must |
Informal |
|
|
Glossary | Must | Must | Must | Must | Formal-External | ||
Requirements Attributes | Must | Must | Must | Must | Formal-Internal | ||
Requirements Management Plan | Must | Must | Must | Must | Formal- Internal |
||
Stakeholder Requests | Must | Must | Must | Must | Formal-External | ||
Software Requirements Specification | Must | Must | Must | Must | Formal-External | ||
Supplementary Specification | Must | Must | Must | Must | Formal-External | ||
Use Case | Must | Must | Must | Must | Formal-External | ||
Use-Case Model | Must | Must | Must | Must | Formal-External | ||
Use-Case Package | Must | Must | Must | Must | Informal | ||
Use-Case Storyboard | Won't | Must | Could | Could | Informal | ||
User-Interface Prototype | Won't | Must | Could | Could | Formal-External | ||
Vision | Must | Must | Must | Must | Formal-External |
See the project's Configuration Management Plan for information about how the work products are configuration-managed.
Reports | How to Use | Templates/Examples | Tools Used |
---|---|---|---|
Actor | Could | ||
Use-Case | Could |
|
|
Use-Case Model Survey | Could |
|
|
Use-Case Storyboard | Could |
A real-time application is not being developed, therefore the Capsule Designer role and the task Capsule Design are excluded. For details on the activity, see the Analysis & Design Overview .
Work Products | How to use | Review Details | Tools used | Templates/ Examples |
|||
---|---|---|---|---|---|---|---|
Incep | Elab | Const | Trans | ||||
Data Model | Won't | Could | Could | Could | Informal | Rational Rose | |
Deployment Model | Could | Must | Must | Must | Formal- Internal |
Rational Rose | |
Design Class | Could | Must | Must | Must | Informal | Rational Rose | |
Design Model | Could | Must | Must | Must | Formal- Internal |
Rational Rose | |
Design Package | Could | Must | Must | Must | Formal- Internal |
Rational Rose | |
Design Subsystem | Could | Must | Must | Must | Formal- Internal |
Rational Rose | |
Interface | Could | Must | Must | Must | Formal- Internal |
Rational Rose | |
Reference Architecture | Could | Must | Must | Must | Formal- Internal |
Rational Rose | |
Software Architecture Document (SAD) | Could | Must | Must | Must | Formal- External |
Rational
SoDA Microsoft Word |
|
Use-Case Realization | Could | Must | Must | Must | Informal | Rational Rose |
The project is not developing a real-time product, which means that the following work products will not developed: Capsule, Event, Protocol, and Signal.
The project decided not to keep an analysis model, which means that the following work products will not be developed: Analysis Class and Analysis Model.
Reports | How to Use | Templates/Examples | Tools Used |
---|---|---|---|
Class | Could | Rational SoDA Microsoft Word |
|
Design-Model Survey | Could | Rational SoDA Microsoft Word |
|
Design Package/Subsystem | Could | Rational SoDA Microsoft Word |
|
Use-Case Realization | Could | Rational SoDA Microsoft Word |
No changes in the activity. For details see the Implementation Overview.
Work Products | How to use | Review Details | Tools used | Templates/ Examples |
|||
---|---|---|---|---|---|---|---|
Incep | Elab | Const | Trans | ||||
Build | Could | Must | Must | Must | Informal | Microsoft(R); Visual Basic(R); | |
Implementation Element | Could | Must | Must | Must | Informal
Code reviews |
Microsoft Visual Basic | |
Implementation Model |
Could |
Must |
Must |
Must |
Informal |
Microsoft Visual Basic |
|
Implementation Subsystem |
Could |
Must |
Must |
Must |
Formal- Internal |
Microsoft Visual Basic |
|
Integration Build Plan | Could | Must | Must | Must | Formal- Internal |
Microsoft Word |
Informal code reviews are performed.
No formal performance test is done, otherwise the activity is followed unchanged. For details on the process, see the Test: Overview .
Work Products | How to use | Review Details | Tools used | Templates/ Examples |
|||
---|---|---|---|---|---|---|---|
Incep | Elab | Const | Trans | ||||
Test Plan | Could | Could | Must | Must | Informal | Microsoft Word | |
Test-Ideas List | Won't | Could | Must | Must | Informal | Microsoft Word | |
Test Case |
Won't |
Could |
Must |
Must |
Informal |
Microsoft Word |
|
Test Data |
Won't |
Could |
Must |
Must |
Informal |
Rational Rose |
|
Workload Model |
Won't |
Could |
Must |
Must |
Informal |
Rational Rose |
|
Test Class |
Won't |
Could |
Must |
Must |
Informal |
Rational Rose |
|
Test Components | Won't | Could | Must | Must | Informal | Microsoft Visual Basic | |
Test Results | Won't | Could | Must | Must | Informal | Microsoft Word | |
Test Evaluation Summary | Won't | Could | Must | Must | Informal | Microsoft Word | |
Test Suite | Won't | Could | Must | Must | Informal | Rational Rose | |
Test Script | Won't | Could | Must | Must | Informal | Rational TestStudio | |
Test Environment Configuration | Won't | Could | Must | Must | Informal | Rational Rose | |
Test Automation Architecture | Won't | Could | Must | Must | Informal | Rational Rose | |
Test Interface Specification | Won't | Could | Must | Must | Informal | Rational Rose |
No Workload Analysis Document is developed.
A previously existing deployment activity was adapted to use the work products suggested in the RUP. An exception is the Course Material work product, which is excluded because no formal training is produced for our product.
Work Products | How to use | Review Details | Tools used | Templates/ Examples |
|||
---|---|---|---|---|---|---|---|
Incep | Elab | Const | Trans | ||||
Bill of Materials |
Won't |
Won't |
Could |
Must |
Formal- Internal |
Microsoft Word |
|
Deployment Plan |
Won't |
Could |
Must |
Must |
Informal |
Microsoft Word |
|
Deployment Unit |
Won't |
Could |
Could |
Must |
Informal |
Microsoft Word |
|
Support Material |
Won't |
Could |
Could |
Must |
Informal |
Microsoft Word |
|
Installation Work Products | Won't | Could | Could | Must | Informal |
Microsoft Word |
|
Product | Won't | Could | Could | Must | Formal- External |
||
Product Artwork | Won't | Could | Could | Must | Informal |
Microsoft Word |
|
Release Notes | Won't | Could | Could | Must | Formal- Internal |
Microsoft Word |
No Training Materials are developed because the product does not require formal training.
Reports | How to Use | Templates/Examples | Tools Used |
---|---|---|---|
|
|
No changes in the activity. For details on the process, see the Configuration & Change Management: Overview .
Work Products | How to use | Review Details | Tools used | Templates/ Examples |
|||
---|---|---|---|---|---|---|---|
Incep | Elab | Const | Trans | ||||
Change Request |
Won't |
Could |
Must | Must | Informal |
Rational ClearQuest |
|
Configuration Audit Findings |
Won't |
Could |
Must |
Must |
Informal |
Microsoft Word |
|
Configuration Management Plan | Won't | Must | Must | Must | Informal |
Microsoft Word |
|
Project Repository | Won't | Could | Must | Must | None | Rational ClearCase | |
Workspace | Won't | Could | Must | Must | None | Rational ClearCase |
No changes to the activity. Additional information: Project Management: Overview .
Work Products | How to use | Review Details | Tools used | Templates/ Examples |
|||
---|---|---|---|---|---|---|---|
Incep | Elab | Const | Trans | ||||
Business Case |
Must |
Must |
Could |
Could |
Formal- External |
Microsoft(R); Word(R); | |
Iteration Assessment |
Must |
Must |
Must |
Must |
Informal |
Microsoft Word |
|
Iteration Plan | Could | Must | Must | Must | Informal | Microsoft Word | |
Measurement Plan | Could | Could | Could | Could | Informal | Microsoft Word | |
Problem Resolution Plan | Must | Must | Must | Must | Informal | Microsoft Word | |
Product Acceptance Plan | Could | Must | Must | Must | Informal | Microsoft Word | |
Project Measurements | Could | Could | Must | Must | Informal | Microsoft Word | |
Quality Assurance Plan | Could | Could | Could | Could | Informal | Microsoft Word | |
Review Record | Must | Must | Must | Must | Informal | Microsoft Word | |
Risk List | Must | Must | Must | Must | Formal- Internal |
Microsoft Word | |
Risk Management Plan | Could | Must | Must | Must | Informal | Microsoft Word | |
Software Development Plan (SDP) | Won't | Could | Must | Must | Formal- Internal |
Microsoft
Word Microsoft Project |
|
Status Assessment | Could | Must | Must | Must | Informal | Microsoft Word |
The work product Work Order won't be used.
No changes in the activity. For details on the process, see the Environment: Overview .
Work Products | How to use | Review Details | Tools used | Templates/ Examples |
|||
---|---|---|---|---|---|---|---|
Incep | Elab | Const | Trans | ||||
Design Guidelines |
Won't |
Must |
Must |
Must |
Informal | Microsoft Word | |
Development Case | Must | Must | Must | Must | Informal | Microsoft(R); FrontPage; | |
Development Infrastructure | Must | Must | Must | Must | Informal | Microsoft Word | |
Development-Organization Assessment | Must | Won't | Won't | Won't | Informal | Microsoft Word | |
Manual Styleguide | Won't | Could | Must | Must | Informal | Microsoft Word | |
Project-Specific Templates | Must | Must | Must | Must | Informal | Microsoft Word | |
Programming Guidelines | Won't | Must | Must | Must | Informal | Microsoft Word | |
Test Guidelines | Won't | Must | Must | Must | Informal | Microsoft Word | |
Tools | Must | Must | Must | Must | Informal | Microsoft Word document | |
Tool Guidelines | Won't | Could | Must | Must | Informal | Microsoft Word | |
Use-Case Modeling Guidelines | Must | Must | Must | Must | Informal | Microsoft Word | |
User-Interface Guidelines | Won't | Must | Must | Must | Informal | Microsoft Word |
Not applicable.