ISO/IEC/IEEE DIS 26513
Systems and software engineering - Requirements·for·testers·and·reviewers·of·user·documentation
Publication Date: 03/21/2016 - Complete Document
This standard supports the interest of software users in receiving consistent, complete, accurate, and usable documentation and specifies processes for use in testing and reviewing of user documentation (clause 6). It is not limited to the test and review stage of the lifecycle, but includes activities throughout the information management and documentation management process.
This standard is intended for use in all types of organizations, whether or not a dedicated documentation department is present. In all cases, it may be used as a basis for local standards and procedures. Readers are assumed to have experience or general knowledge of testing or reviewing processes.
This standard deals with the evaluation of end-user content only, and not with the evaluation of the software it supports.
NOTE 1 Documentation is also included in evaluation of the softw are product, as in the ISO/IEC 25000 series of standards. In particular:
• ISO/IEC 25060:2010 Systems and software engineering—Systems and software product Quality Requirements and Evaluation (SQuaRE) – Common Industry Format (CIF) for usability: General framework for usability-related information;
• ISO/IEC 25062:2006 Software engineering—Software product Quality Requirements and Evaluation (SQuaRE) – Common Industry Format (CIF) for usability test reports;
• ISO/IEC 25063:2014 Systems and software engineering—Systems and software product Quality Requirements and Evaluation (SQuaRE) – Common Industry Format (CIF) for usability: Context of use description;
• ISO/IEC 25064:2013 Systems and software engineering—Software product Quality Requirements and Evaluation (SQuaRE) – Common Industry Format (CIF) for usability: User needs report.
This standard provides the minimum requirements for testing and reviewing user documentation (clause 7), including both printed and online documents used in work and other environments by the users of software which includes application software, systems software, and software that controls machinery or hardware devices. It applies to printed user manuals, online help, user assistance for mobile devices, tutorials, websites, and user reference documentation.
This InternationalStandard may also be helpful for testing and reviewing the following types of documentation:
• documentationof products other than software, for example, hardware or devices;
• multimediasystems usinganimation, video, and sound
• tutorial packages and specialized course materials intended primarily for use in formal trainingprograms;
• documentation produced for installers, computer operators, or system administrators who are not end users;
• maintenancedocumentationdescribing the internal operationof systems software.
This International Standard is applicable to testers, reviewers, and other related roles, including a variety of specialists:
• usability testers, documentation reviewers, and subject-matter experts;
• information developers and architects who plan the structure and format of products in a documentation set;
• usability analysts and business analysts who identify the tasks the intended users perform with the software;
• test participants;
• installers, computer operators, or system administrators;
• customer support groups such as training, help desks, repair and return.
The standard may also be consulted by those with other roles and interests in the information management process. Managers of the software development process or the information management process should consider the testing of documentation as part of their planning and management activities. Project managers, in particular, have an important role in supporting the review and testing of documentation.
Testing of the documentation is likely to highlight any defects or nonconformances in tools that are used to create or display online documentation. Similarly, usability testing of the documentation is likely to identify additional operational concerns or misunderstandings of end users.
NOTE 2 Testing of documentation can highlight problems w ith the softw are being documented. Resolving problems w ith the softw are is not in the scope of this standard.
There are other roles that need to understand the test processes for the documentation; for example, information developers should understand the test processes for the documentation that they have produced, and acquirers of documentation prepared by another department or organization may want to know what testing has been performed and the processes followed for the documentation that they are acquiring from a supplier.
The order of clauses in this standard does not imply that software user documentation should be reviewed, assessed, edited, or tested in this order.
In each clause, the requirements are media-independent, as far as possible. The informative guidelines found in Annex A, User-Centered Test and Review Guidelines, may be used at each stage of the information management process to verify that the correct steps have been carried out and that the finished product has acceptablequality.
The works listed in the Bibliography provide additional guidance on the processes of managing, preparing, and testing of user documentation.
Document Type : Complete Document
Language : English
Page Count : 47
Publication Date : 03/21/2016
Revision : 16
Status : Current
Title : Systems and software engineering - Requirements·for·testers·and·reviewers·of·user·documentation