BSI 21/30399910 DC:2021 Edition

This clause presents the scope, purpose, organization, and candidate uses of this document.

This document supports the need of software users for consistent, complete, accurate, and usable information. It includes both approaches to standardization: a) process standards, which specify the way in which information products are to be developed; and b) information product standards, which specify the characteristics and functional requirements of the information for users.

This document covers the development process for designers and developers of information for users of software. It describes how to establish what information users need, how to determine the way in which that information should be presented, and how to prepare the information and make it available. It is not limited to the design and development stage of the life cycle, but includes information on design throughout the life cycle, such as design strategy and maintaining a design.

This document provides requirements for the structure, information content, and format of information for users of software.

This document can be applied to develop the following types of information, although it does not cover all aspects of them:

• information for users of products other than software;

• multimedia systems using animation, video, and sound;

• computer-based training (CBT) packages and specialized course materials intended primarily for use in formal training programs;

• maintenance information describing the internal operation of systems software;

• information for users incorporated into the user interface itself.

This document is applicable to information architects and information developers, including a variety of specialists:

• information architects who plan the structure and format of information products;

• usability specialists and business analysts who identify the tasks that the intended users can perform with the software;

• developers and editors of the written content of information for users;

• graphic designers with expertise in electronic media;

• user interface designers and ergonomics experts working together to design the presentation of the information on the screen.

This document is also a reference for those with other roles and interests in the process of developing information for users:

• managers of the software development process or the information-development process;

• acquirers of information for users prepared by suppliers;

• usability testers, reviewers of information for users, subject-matter experts;

• developers of tools for creating information for users;

• human-factors experts who identify principles for making information for users more accessible and easily used.

This document is intended for use in all types of organizations, whether or not a dedicated information-development department is present, and may be used as a basis for local standards and procedures. Readers are assumed to have experience or knowledge of software development or information-development processes.

The order of clauses in this document does not imply that the information for users should be developed in this order or presented to the user in this order.

In each clause, the requirements are media-independent, as far as possible. Requirements specific to either print or electronic media are identified as such, particularly in clause 9.