Full Description
Scope
This International Standard supports the interest of software users in receiving consistent, complete, accurate, and usable documentation. This International Standard defines the process in which user documentation products are tested. This International Standard is intended neither to encourage nor discourage the use of either printed or electronic (on-screen) media for documentation, or of any particular documentation testing or management tools or methodologies. This International Standard specifies processes for use in testing and reviewing of user documentation (Clause 5). It is not limited to the test and review phase of the life cycle, but includes activities throughout the Information Management and Documentation Management processes. This International Standard provides the minimum requirements for the testing and reviewing of user documentation (Clause 6), including both printed and on-screen documents used in the work environment by the users of systems software. It applies to printed user manuals, online help, tutorials, and user reference documentation. The order of clauses in this International Standard does not imply that the software user documentation should be tested in this order. In each clause, the requirements are media-independent, as far as possible. The informative checklists found in Annexes A and B may be used at each phase of the documentation process to verify that the appropriate steps have been carried out, and that the finished product has acceptable quality. This International Standard can be helpful for testing and reviewing the following types of documentation: * documentation of products other than software, for example, hardware or devices; * multimedia systems using animation, video, and sound; * computer-based training (CBT) packages and specialized course materials intended primarily for use in formal training programs; * documentation produced for installers, computer operators, or system administrators who are not end users; * maintenance documentation describing the internal operation of 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 designers and architects who plan the structure and format of products in a documentation set; * usability specialists and business analysts who identify the tasks the intended users will perform with the software. The International Standard can also be consulted by those with other roles and interests in the documentation process. Managers of the software development process or the documentation process should consider the testing of documentation as part of their planning and management activities. Project managers, in particular, have an important role in planning the testing and reviewing of documentation. Testing of the documentation is likely to highlight any defects or nonconformances in tools that are used to create or display on-screen documentation. Similarly, usability testing of the documentation is likely to highlight defects or nonconformances with the presentation or layout of documentation and associated graphics and other media. As a result, there are a number of roles that should be involved in the testing of documentation because their work affects the content, display or presentation of documentation for the user, for example, developers of tools for creating on-screen documentation, graphic designers producing material displayed as part of the documentation, and human-factors experts who identify principles for making documentation more accessible and easily used, also user interface designers and ergonomics experts working together to design the presentation of the documentation on-screen.
Abstract
New IEEE Standard - Active.This standard provides requirements for the test and review of software user documentation as part of the life cycle processes. It defines the documentation process from the viewpoint of the documentation tester and reviewer. It specifies process for use in testing and reviewing of user documentation, and provides the minimum requirements for these activities. It is relevant to roles involved in testing and development of software and user documentation, including project managers, usability experts and information developers, in addition to testers and reviewers. It applies to both printed documentation and on-screen documentation, and is applicable to user documentation for systems including hardware.
