Systems and software engineering Content of systems and software life cycle process information products (Documentation)
|Publication Date:||15 April 2006|
|ICS Code (Software):||35.080|
This International Standard assumes an organization is implementing life cycle processes in conformance with ISO/IEC 15288:2002 or ISO/IEC 12207:1995, with Amendments 1 and 2. ISO/IEC 15288:2002 defines a set of processes for managing and performing the stages of a systems life cycle. It defines an Information Management process, but "does not detail documentation in terms of name, format, explicit content, and recording media" (1.3). ISO/IEC 12207:1995 with AMD 1 and 2, establishes a common framework for software life cycle processes, and in passing identifies or requires a number of documentation items.
The purpose of this International Standard is to guide users of ISO/IEC 12207:1995 (with Amendments 1 and 2) and ISO/IEC 15288:2002 in identifying and planning the specific information items to be produced during systems and software life cycles. As stated in G.5 of IEEE/EIA 12207.0:1996, This International Standard identifies the purpose and content of all identified Systems and Software Life Cycle information items. The information item contents are defined according to generic document types, as presented in Clause 7, and the specific purpose of the document (Clause 10). The generic document types (which may be referred to as information item types to conform to ) are to be used to identify the information necessary to support the ISO/IEC 15288:2002 agreement, enterprise, project, and technical processes; and the ISO/IEC 12207:1995, primary, supporting, and organizational life cycle processes.
This International Standard identifies records and information items based on analysis of references in ISO/IEC 15288:2002 and ISO/IEC 12207:1995, which in some cases provide partial or complete outlines for the content of specific documents. However, the requirements for the life-cycle processes do not uniquely and unambiguously state the requirements for the information items contents or the information needed by a user of an information item. Moreover, the information from the life-cycle processes may overlap or may be created and revised at different times. In short, the analyzed references do not result in a logically complete list of information items. For example, for each life-cycle process, it would be possible to prepare a plan, procedures, and reports, as well as numerous records, requests, descriptions and specifications. Such an elaboration of a documentation schema would be more rigorous than specified by either ISO/IEC 15288:2002 or ISO/IEC 12207:1995. Thus, information items may be combined or subdivided as needed for project or organizational purposes, as further defined in Clause 2, Applicability, and Clause 3, Conformance.
NOTE ISO/IEC 15504-5 provides guidance on the content of work products as well as information items. Its guidance includes descriptions of a set of information items (documents), which an assessor may encounter. The information items in its guidance may be produced by combinations and subdivisions of the required information items in this International Standard.
This International Standard:
a) Addresses the technical information needed by those involved in ISO/IEC 15288:2002 and ISO/IEC 12207:1995 (with Amendments 1 and 2) processes;
b) Is intended for use in an agreement process as described in ISO/IEC 15288:2002 or a two-party situation as described in ISO/IEC 12207:1995. The two-party situation may range from an informal agreement within an organization or to a legally binding contract between organizations;
c) May be used by a single party as self-imposed tasks;
d) May be applied to any type of project and life-cycle process;
e) May be applied to any of the activities and tasks of a project and system or software product or service life cycle;
f) Is not limited by size, complexity or criticality of the project;
g) May be applied to all forms of information items, information item content and document delivery media;
h) May be used for information items described in
i) May be used to develop information items that provide evidence for process assessment performed with respect to ISO/IEC 15504: Process Assessment, and to guide process improvement activities.
Not included in the scope of this International Standard are:
- Information items showing only approval of an ISO/IEC 12207:1995 subclause, such as ISO/IEC 12207:1995, 220.127.116.11;
- Any ISO/IEC 15288:2002 or ISO/IEC 12207:1995 subclause not explicitly or implicitly identifying the recording of information about an activity or task, for example, ISO/IEC 12207:1995, 18.104.22.168;
- The form and content of approving information items or organizational management information such as business strategies, human resources and investment policies, personnel selection criteria, or payroll data;
- Instructions on combining or subdividing information items and information item contents of a similar nature;
- Guidance on selecting an appropriate presentation format, delivery media, and maintenance technology for system and software life cycle data, records, information items, or documentation, such as electronic publishing systems or data repositories;
NOTE ISO/IEC 18019-2004 provides guidance on formats for software user documentation.