Working Group Details
15289_WG - Life Cycle Documentation (Information Items)
|Working Group Chair||
|IEEE Program Manager|
P15289 - ISO/IEC/IEEE Draft International Standard -- Systems and Software Engineering -- Content of Life-Cycle Information Items (Documentation)
This document specifies the purpose and content of all identified systems and software life-cycle and services information items (documentation). 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). This document assumes an organization is performing life-cycle processes, or delivering services, using either ISO/IEC/IEEE 12207:2017, Systems and software engineering -- Software life cycle processes, or ISO/IEC/IEEE 15288:2015, Systems and software engineering -- System life cycle processes. This document provides a mapping of processes from the above standards to a set of information items. It provides a consistent approach to meeting the information and documentation requirements of systems and software engineering and life-cycle services. This document does not establish a service management system. ISO/IEC/IEEE 12207:2017 and ISO/IEC/IEEE 15288:2015 define a set of processes, identical in purpose and outcomes but with different activities and tasks, for managing and performing the stages of a software or system life cycle. They define an Information Management process, but do not detail information items in terms of name, format, explicit content, and recording media. The generic document types defined in this document are used to identify the information necessary to support the ISO/IEC/IEEE 12207:2017 and ISO/IEC/IEEE 15288:2015 agreement; organizational project-enabling, technical management, and technical processes. For each life-cycle process or service, it would be possible to prepare a policy, plan, procedures, and reports, as well as numerous records, requests, descriptions and specifications. Such an elaboration of the documentation schema would be more rigorous than specified by ISO/IEC/IEEE 15288:2015 or ISO/IEC 12207:2017. As ISO/IEC/IEEE 15288:2015 points out (1.4), "The users of this document are responsible for selecting a life cycle model for the project and mapping the processes, activities, and tasks in this document into that model. The parties are also responsible for selecting and applying appropriate methodologies, methods, models and techniques suitable for the project." Thus, information items are combined or subdivided consistent with the life cycle model, as needed for project or organizational purposes, as further defined in Clause 4, Applicability, and Clause 5, Conformance.
15289-2011 - ISO/IEC/IEEE Systems and software engineering -- Content of life-cycle information products (documentation)
ISO/IEC/IEEE 15289:2011 provides requirements for identifying and planning the specific information items (information products, documentation) to be developed and revised during systems and software life cycles and service processes. It specifies the purpose and content of all identified systems and software data records and life cycle information items, as well as records and information items for information technology service management. The information item contents are defined according to generic document types (description, plan, policy, procedure, report, request, and specification) and the specific purpose of the document. For simplicity of reference, each information item is described as if it were published as a separate document. However, information items may be unpublished but available in a repository for reference, divided into separate documents or volumes, or combined with other information items into one document. ISO/IEC/IEEE 15289:2011 is based on the life cycle processes specified in ISO/IEC 12207:2008 (IEEE Std 12207-2008) and ISO/IEC 15288:2008 (IEEE Std 15288-2008), and the service management processes specified in ISO/IEC 20000-1:2005 and ISO/IEC 20000-2:2005.
15289-2015 - ISO/IEC/IEEE International Standard Systems and software engineering -- Content of life-cycle information items (documentation)
The purpose and content of all identified systems and software life cycle and service management information items (documentation) are specified in this standard. 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). This International Standard provides a mapping of ISO/IEC/IEEE 15288, ISO/IEC 12207:2008 (IEEE Std 12207-2008), ISO/IEC 20000-1:2011 (IEEE Std 20000-1:2013), and ISO/IEC 20000-2 (IEEE Std 20000-2:2013) clauses with a set of information items. This International Standard identifies records and information items based on analysis of references in ISO/IEC/IEEE 15288, ISO/IEC 12207:2008 (IEEE Std 12207-2008), ISO/IEC 20000-1:2011 (IEEE Std 20000-1:2013) and ISO/IEC 20000-2:2012 (IEEE 20000-2:2013), 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.
82079-1-2019 - IEEE/IEC International Approved Draft Standard Preparation of Information for Use (Instructions for Use) of Products - Part 1: Principles and General Requirements
This part of ISO/IEC 82079 provides principles and general requirements for the creation and provision of information for use of products, available electronically or printed, which are * necessary for the safe use, * helpful for the efficient and effective use, or * needed to fulfil market and regulatory requirements. Information for use of products includes instructions for use, service manuals, installation guides, operation and maintenance instructions, and assembly instructions for systems and software. The term "product" includes systems, software, and services. It includes both products intended for consumer use and for industrial use; financial, social, or customer services; and complex system-of-systems such as power plants, refineries, and factories. This International Standard may be helpful for developing the following types of documentation, although it does not cover all aspects of them: computer-based training (CBT) packages and specialized course materials intended primarily for use in formal training programs This International Standard neither encourages nor discourages the use of either printed or electronic tools or methodologies.