Design Work Products
Definitions
- Design Work Product
- a work product
that may be produced during the
design activity
- Design Set of Work Products
- the cohesive collection of design work products
Work Products
The OPF repository contains the following set of predefined
design work products:
-
Class Responsibility Collaborator Card,
which is a design work product consisting of a large
index card that informally documents the responsibilities and
collaborators of a class during software design and the
programming of class comments.
-
Contact Center Design Document,
which formally documents the design of a contact (i.e.,
call) center.
-
Database Design Document,
which formally documents the design of the databases
that will be part of the application.
-
Data Center Design Document,
which formally documents the design of a data
center.
-
Data Dictionary,
which formally documents the data of an application,
database, or enterprise.
-
Hardware Design Document,
which formally documents the design of the individual
hardware components.
-
Human Interface Design Document,
which formally documents the design of all human
interfaces.
-
Human Interface Prototype,
which is a prototype of an application's human
interfaces.
-
Javadoc,
which is the class and method level API documentation
in HTML format that is automatically generated from comments
in Java source code (e.g., by the tool from Sun
Microsystems).
-
Software Design Document,
which formally documents the design of the individual
software components.
Guidelines
- Different endeavors require different processes, which in
turn will require different design work products.
- Every endeavor does not require the production of every
design work product.
- Select only those design work products that are
appropriate for the endeavor.
- Selected design work products should be:
- Relevant.
- Useful.
- Usable.
- Cost-effective.