ISO/IEC 23396:2020
(Main)Systems and software engineering — Capabilities of review tools
Systems and software engineering — Capabilities of review tools
This document specifies the capabilities of a tool to support review work. The evaluation and selection of the review tools are performed in accordance with ISO/IEC 20741 which defines the general evaluation selection process and evaluation characteristics. This document defines capabilities specific to review tools in the process. By using these two standards together, it is possible to derive objective and reasonable results of the evaluation and selection of review tools. The review work is based on the process, activities, and tasks defined in ISO/IEC 20246. It is also assumed that the review targets are defined in ISO/IEC 20246. The review work in this document is assumed not to be performed by a 3rd party, but within a project. The review tool capabilities specified in this document harmonize with the review process defined in ISO/IEC 20246. This document does not include automated process, activities, or tasks for conducting reviews such as automated source code checkers defined in ISO/IEC 30130. Issues which are identified in the review are recorded and managed by the tool; but defects found in tests and issues found in general except for reviews are out of the scope of this document.
Ingénierie des systèmes et du logiciel — Capacités des outils d'analyse
General Information
Standards Content (Sample)
INTERNATIONAL ISO/IEC
STANDARD 23396
First edition
2020-07
Systems and software engineering —
Capabilities of review tools
Ingénierie des systèmes et du logiciel — Capacités des outils d'analyse
Reference number
©
ISO/IEC 2020
© ISO/IEC 2020
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
CP 401 • Ch. de Blandonnet 8
CH-1214 Vernier, Geneva
Phone: +41 22 749 01 11
Email: copyright@iso.org
Website: www.iso.org
Published in Switzerland
ii © ISO/IEC 2020 – All rights reserved
Contents Page
Foreword .v
Introduction .vi
1 Scope . 1
2 Normative references . 1
3 Terms and definitions . 1
4 Object model for review tools . 2
4.1 Overview of the object model . 2
4.2 Object model of review entities . 2
4.3 Category of capabilities for review tools . 3
5 Entities of review tools . 5
5.1 Overview . 5
5.2 ReviewFolder . 5
5.3 Review . 6
5.4 Member . 6
5.5 WorkProduct . 7
5.6 IssueByReview . 7
5.7 PlaceOfIssueByReview . 7
6 Capabilities of review tools . 8
6.1 Overview . 8
6.2 Administration . 8
6.2.1 Overview . 8
6.2.2 Administration of review folder . 8
6.2.3 Review definition . 9
6.2.4 Control of review implementation . 9
6.2.5 Dashboard of review progress .10
6.3 IssueByReview management .10
6.3.1 Creation, deletion, reference, and update of issues .10
6.3.2 Highlighting place of issue .11
6.3.3 Transition of issue status .11
6.3.4 Issue confirmation support .11
6.3.5 Similar issue detection support .11
6.3.6 Issue entry support .12
6.4 Review metrics collection and report output .12
6.4.1 Review metrics collection .12
6.4.2 Report output .12
6.5 Human communication support .13
6.5.1 Overview .13
6.5.2 Notification of events and schedule information of the review .13
6.5.3 Online chat between review participants .13
6.5.4 Messaging with specific review participants .13
6.5.5 Sharing issues among review participants .13
6.5.6 Sharing work product view on a screen among review participants .13
6.6 Linkage with other tools .13
6.6.1 Overview .13
6.6.2 Importing and exporting member definition .14
6.6.3 Importing and exporting classification definition .14
6.6.4 Importing and exporting viewpoints of review .14
6.6.5 Importing work products to be reviewed .14
6.6.6 Exporting identified issues .14
6.6.7 Exporting review findings .14
Annex A (informative) Review tool entities and attributes .15
© ISO/IEC 2020 – All rights reserved iii
Annex B (informative) Review tool entities CRUD matrix .19
Annex C (informative) Review tool capabilities and review activities .20
Annex D (informative) Scope of review tools .22
Annex E (informative) How to use this document with ISO/IEC 20741 .23
Annex F (informative) Use case of a review tool .24
Bibliography .31
iv © ISO/IEC 2020 – All rights reserved
Foreword
ISO (the International Organization for Standardization) and IEC (the International Electrotechnical
Commission) form the specialized system for worldwide standardization. National bodies that
are members of ISO or IEC participate in the development of International Standards through
technical committees established by the respective organization to deal with particular fields of
technical activity. ISO and IEC technical committees collaborate in fields of mutual interest. Other
international organizations, governmental and non-governmental, in liaison with ISO and IEC, also
take part in the work.
The procedures used to develop this document and those intended for its further maintenance are
described in the ISO/IEC Directives, Part 1. In particular, the different approval criteria needed for
the different types of document should be noted. This document was drafted in accordance with the
editorial rules of the ISO/IEC Directives, Part 2 (see www .iso .org/ directives).
Attention is drawn to the possibility that some of the elements of this document may be the subject
of patent rights. ISO and IEC shall not be held responsible for identifying any or all such patent
rights. Details of any patent rights identified during the development of the document will be in the
Introduction and/or on the ISO list of patent declarations received (see www .iso .org/ patents) or the IEC
list of patent declarations received (see http:// patents .iec .ch).
Any trade name used in this document is information given for the convenience of users and does not
constitute an endorsement.
For an explanation of the voluntary nature of standards, the meaning of ISO specific terms and
expressions related to conformity assessment, as well as information about ISO's adherence to the
World Trade Organization (WTO) principles in the Technical Barriers to Trade (TBT), see www .iso .org/
iso/ foreword .html.
This document was prepared by Joint Technical Committee ISO/IEC JTC 1, Information technology,
Subcommittee SC 7, Software and systems engineering.
Any feedback or questions on this document should be directed to the user’s national standards body. A
complete listing of these bodies can be found at www .iso .org/ members .html.
© ISO/IEC 2020 – All rights reserved v
Introduction
It is widely recognized that almost all software development organizations need to improve the quality
of software at an appropriate cost and review is one important means. Applying reviews early in the
lifecycle is known to reduce the amount of unnecessary rework in regular projects. This is because
problem detection in upstream requires less cost than detection of problems by performing tests in
downstream processes. By conducting the review in this way, it is possible to detect problems early,
evaluate alternatives, improve organizational and personal processes, and improve work outcomes.
ISO/IEC 20246 specifies a standard process for work product reviews.
Review support tools provide capabilities to improve review work and improve review quality, for
example support for collaboration and communication between reviewers, logging and highlighting
comments made on a work product, and support for review report generation.
Support tools are indispensable in the large-scale development project where the number of i
...
Questions, Comments and Discussion
Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.