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 service management 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, as presented in Clause 10. This document assumes an organization is performing life‐cycle processes, or delivering system or software engineering services, using either or both of the following: — ISO/IEC/IEEE 12207:2017 software life cycle processes; — ISO/IEC/IEEE 15288:2015 system life cycle processes. ISO/IEC/IEEE 12207:2017 and ISO/IEC/IEEE 15288:2015 define an Information Management process, but do not "detail information items in terms of name, format, explicit content, and recording media" (ISO/IEC/IEEE 12207:2017, 1.4). These standards identify, recommend or require a number of documentation items. 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 engineering service management. The generic document types defined in this document are used to identify the information necessary to support the processes required by ISO/IEC/IEEE 12207:2017 and ISO/IEC/IEEE 15288:2015. The generic document types (which can be referred to as information item types) are used to identify the information necessary to support the 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 12207:2017 or ISO/IEC/IEEE 15288:2015. As ISO/IEC/IEEE 15288:2015, 1.4 points out, "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 and Clause 5. This document is not a management system standard and does not establish a service management system, quality management system, or asset management system. The scope of this document does not include the following: a) the format or content of recommended input data or input information items, except for the content of those input items that are also output information items; b) instructions on combining or subdividing information items and information item contents of a similar nature; c) guidance on selecting an appropriate presentation format, delivery media and maintenance technology for systems or software life‐cycle data, records, information items or documentation, such as electronic publishing systems, content management systems or data repositories; NOTE ISO/IEC/IEEE 26531 provides requirements for content management and component content management systems. ISO/IEC 26514 provides guidance on formats for user documentation (information for users). d) detailed content for information items related to general business, contractual, organizational and financial management that is not specific to systems and software engineering and engineering service management, such as business strategies, contract change notices (agreement change report), human resources and investment policies, personnel selection criteria, financial budgeting and accounting policies and procedures, cost reports, or payroll data; e) information items showing only approval of an ISO/IEC/IEEE 12207:2017 or ISO/IEC/IEEE 15288:2015 subclause, such as ISO/IEC/IEEE 12207:2017, 6.4.10.3 c) 3

Ingénierie des systèmes et du logiciel — Contenu des articles d'information du cycle de vie (documentation)

General Information

Status
Published
Publication Date
22-Jul-2019
Current Stage
9020 - International Standard under periodical review
Start Date
15-Jul-2024
Completion Date
15-Jul-2024
Ref Project

Relations

Buy Standard

Standard
ISO/IEC/IEEE 15289:2019 - Systems and software engineering — Content of life-cycle information items (documentation) Released:7/23/2019
English language
73 pages
sale 15% off
Preview
sale 15% off
Preview
Standard
ISO/IEC/IEEE 15289:2019 - Systems and software engineering -- Content of life-cycle information items (documentation)
English language
73 pages
sale 15% off
Preview
sale 15% off
Preview

Standards Content (Sample)


INTERNATIONAL ISO/IEC/
STANDARD IEEE
Fourth edition
2019-07
Systems and software engineering —
Content of life-cycle information items
(documentation)
Ingénierie des systèmes et du logiciel — Contenu des articles
d'information du cycle de vie (documentation)
Reference number
©
ISO/IEC 2019
©
IEEE 2019
© ISO/IEC 2019
© IEEE 2019
All rights reserved. Unless otherwise specified, or required in the context of its implementation, no part of this publication may
be reproduced or utilized otherwise in any form or by any means, electronic or mechanical, including photocopying, or posting
on the internet or an intranet, without prior written permission. Permission can be requested from either ISO at the address
below or ISO’s member body in the country of the requester.
ISO copyright office Institute of Electrical and Electronics Engineers, Inc
CP 401 • Ch. de Blandonnet 8 3 Park Avenue, New York
CH-1214 Vernier, Geneva NY 10016-5997, USA
Tel. +41 22 749 01 11
Fax +41 22 749 09 47
copyright@iso.org stds.ipr@ieee.org
www.iso.org www.ieee.org
Published in Switzerland
© ISO/IEC 2019 – All rights reserved
ii © IEEE 2019 – All rights reserved

Contents Page
Foreword .vi
Introduction .vii
1 Scope . 1
2 Normative references . 2
3 Terms, definitions and abbreviated terms . 2
3.1 Terms and definitions . 2
3.2 Abbreviated terms . 5
4 Applicability . 5
4.1 Purpose . 5
4.2 Intended users of this document . 6
4.3 Applicability to work efforts . 6
4.4 Applicability to information item audiences . 6
5 Conformance . 7
5.1 Definition of conformance . 7
5.2 Conformance situations . 7
5.3 Type of conformance . 8
6 Life-cycle data and information items . 8
6.1 Life-cycle data characteristics . 8
6.2 Records compared to information items (documents) . 8
6.3 Management of life-cycle data (records) . 9
6.4 Management of information items (documents) . 9
6.4.1 General. 9
6.4.2 Developing the information management plan .10
6.4.3 Managing and controlling information items .10
7 Generic types of information items .10
7.1 Use of generic types .10
7.2 Description — Generic content .11
7.3 Plan — Generic content .11
7.4 Policy — Generic content .13
7.5 Procedure — Generic content .13
7.6 Report — Generic content .14
7.7 Request — Generic content .15
7.8 Specification — Generic content .16
8 Mapping of information items to the life cycle processes .17
8.1 The process model .17
8.2 Mapping Considerations .18
8.3 Mapping of information items to the system life cycle .18
8.4 Mapping of information items to the software life cycle .23
9 Records .30
9.1 General .30
9.2 Record — Generic content .31
9.3 Specific record contents .31
10 Specific information item (document) contents .35
10.1 General .35
10.2 Acceptance plan .36
10.3 Acceptance report .36
10.4 Acquisition plan .36
10.5 Capacity plan .37
10.6 Change request .37
10.7 Complaint procedure .38
© ISO/IEC 2019 – All rights reserved
© IEEE 2019 – All rights reserved iii

10.8 Concept of operations .38
10.9 Configuration management plan .39
10.10 Configuration management procedure .39
10.11 Configuration status report .40
10.12 Contract .40
10.13 Customer satisfaction survey .41
10.14 Database design description .41
10.15 Design description .42
10.16 Development plan .43
10.17 Evaluation report .43
10.18 Implementation procedure .44
10.19 Improvement plan.44
10.20 Incident management procedure.45
10.21 Incident report .45
10.22 Information management plan .46
10.23 Information management procedure .46
10.24 Information security plan .47
10.25 Installation report .47
10.26 Integration and test report .48
10.27 Integration plan .48
10.28 Interface description .
...


INTERNATIONAL ISO/IEC/
STANDARD IEEE
Fourth edition
2019-07
Systems and software engineering —
Content of life-cycle information items
(documentation)
Ingénierie des systèmes et du logiciel — Contenu des articles
d'information du cycle de vie (documentation)
Reference number
©
ISO/IEC 2019
©
IEEE 2019
© ISO/IEC 2019
© IEEE 2019
All rights reserved. Unless otherwise specified, or required in the context of its implementation, no part of this publication may
be reproduced or utilized otherwise in any form or by any means, electronic or mechanical, including photocopying, or posting
on the internet or an intranet, without prior written permission. Permission can be requested from either ISO at the address
below or ISO’s member body in the country of the requester.
ISO copyright office Institute of Electrical and Electronics Engineers, Inc
CP 401 • Ch. de Blandonnet 8 3 Park Avenue, New York
CH-1214 Vernier, Geneva NY 10016-5997, USA
Tel. +41 22 749 01 11
Fax +41 22 749 09 47
copyright@iso.org stds.ipr@ieee.org
www.iso.org www.ieee.org
Published in Switzerland
© ISO/IEC 2019 – All rights reserved
ii © IEEE 2019 – All rights reserved

Contents Page
Foreword .vi
Introduction .vii
1 Scope . 1
2 Normative references . 2
3 Terms, definitions and abbreviated terms . 2
3.1 Terms and definitions . 2
3.2 Abbreviated terms . 5
4 Applicability . 5
4.1 Purpose . 5
4.2 Intended users of this document . 6
4.3 Applicability to work efforts . 6
4.4 Applicability to information item audiences . 6
5 Conformance . 7
5.1 Definition of conformance . 7
5.2 Conformance situations . 7
5.3 Type of conformance . 8
6 Life-cycle data and information items . 8
6.1 Life-cycle data characteristics . 8
6.2 Records compared to information items (documents) . 8
6.3 Management of life-cycle data (records) . 9
6.4 Management of information items (documents) . 9
6.4.1 General. 9
6.4.2 Developing the information management plan .10
6.4.3 Managing and controlling information items .10
7 Generic types of information items .10
7.1 Use of generic types .10
7.2 Description — Generic content .11
7.3 Plan — Generic content .11
7.4 Policy — Generic content .13
7.5 Procedure — Generic content .13
7.6 Report — Generic content .14
7.7 Request — Generic content .15
7.8 Specification — Generic content .16
8 Mapping of information items to the life cycle processes .17
8.1 The process model .17
8.2 Mapping Considerations .18
8.3 Mapping of information items to the system life cycle .18
8.4 Mapping of information items to the software life cycle .23
9 Records .30
9.1 General .30
9.2 Record — Generic content .31
9.3 Specific record contents .31
10 Specific information item (document) contents .35
10.1 General .35
10.2 Acceptance plan .36
10.3 Acceptance report .36
10.4 Acquisition plan .36
10.5 Capacity plan .37
10.6 Change request .37
10.7 Complaint procedure .38
© ISO/IEC 2019 – All rights reserved
© IEEE 2019 – All rights reserved iii

10.8 Concept of operations .38
10.9 Configuration management plan .39
10.10 Configuration management procedure .39
10.11 Configuration status report .40
10.12 Contract .40
10.13 Customer satisfaction survey .41
10.14 Database design description .41
10.15 Design description .42
10.16 Development plan .43
10.17 Evaluation report .43
10.18 Implementation procedure .44
10.19 Improvement plan.44
10.20 Incident management procedure.45
10.21 Incident report .45
10.22 Information management plan .46
10.23 Information management procedure .46
10.24 Information security plan .47
10.25 Installation report .47
10.26 Integration and test report .48
10.27 Integration plan .48
10.28 Interface description .
...

Questions, Comments and Discussion

Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.