Developing User Software Documents

Anyone who uses application software needs accurate information about how the software will help the user accomplish a task. The documentation may be the first tangible item that the user sees and therefore influences the user’s first impressions of the software product.

ISO 26514:2008 –¬†Systems and Software Engineering – Requirements for Designers and Developers of User Documentation, covers the phases involved in designing, specifying, and producing user documentation. It is divided in two parts:

1. The first part covers the user documentation process for designers and developers of documentation. It describes how to establish what information users need, how to determine the way in which that information should be presented to the users, and how to prepare the information and make it available. It is not limited to the design and development phase of the life cycle, but includes activities throughout the information management and documentation processes.

2. The second part provides minimum requirements for the structure, information content, and format of user documentation, including both printed and on-screen documents used in the work environment by users of systems containing software. It applies to printed user manuals, online help, tutorials, and user reference documentation.

The standard recommends that development of the user documentation should be part of the development of the software product, and follows the same processes as the software product life cycle.

User documentation remains an essential component of usable software products and ISO 26514 may be helpful for developing the following types of documentation:

  • documentation of products other than software
  • multimedia systems using animation, video, and sound
  • computer-based training 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
  • documentation incorporated into the user interface itself

ISO 26514 is the first of a new suite of standards planned to address software user documentation. While ISO 26514 was developed to address the needs of user documentation designers and developers, three further standards are being developed that will address the needs of managers, acquirers and suppliers, and testers and assessors of software user documentation.

You can order ISO 26514:2008 in e-Standard format at this ANSI web site: