User:AndresSalinas97/sandbox

= IEEE 1063 = IEEE 1063 is a superseded standard promulgated by the Institute of Electrical and Electronics Engineers that provides minimum requirements for the structure, information content, and format of software user documentation (both printed and electronic). It is a standard for the documentation phase of the Systems development life cycle.

The last version of this standard (IEEE 1063-2001) was published on December 2001 and reaffirmed on September 2007. It is an update on the IEEE 1063-1987 standard, which was also recognized as an American national standard (ANSI) and was widely used in the preparation of printed user manuals contributing to improvements in documentation quality. This revision provided requirements for both printed and electronic documentation, whereas its predecesor from 1987 only considered printed documentation.

In June 2011 it was superseded by the IEEE/ISO/IEC 26512-2011 standard, of which the latest (and currently active) revision is the ISO/IEC/IEEE 26512:2018 standard published on June 2018. This is a standard with a wider scope that supports the interest of system users in having consistent, complete, accurate, and usable information and provides an overview of the information management processes that are relevant to the acquisition and supply of information for users.

Contents of IEEE 1063-2001
1063-2001 - IEEE Standard for Software User Documentation is a document of approximately 30 pages available for purchase on the IEEE Standards Association website.

It is divided in the following sections:
 * Section 1: Overview
 * Section 2: Definitions
 * Section 3: Structure of software user documentation
 * Section 4: Information content of software user documentation
 * Section 5: Format of software user documentation

Essentially, the layout of the standard is organized according to the different aspects of user documentation: structure (section 3), information content (section 4) and format (section 5). Sections 3 and 4 are, as far as posible, media-independent. Requirements specific to either printed or electronic documentation are identified in section 5.

In general terms the content of this standard is similar to the previous IEEE 1063-1987 with the exception that one section was removed: "Identifying Required User Documents". Sections 3 to 5 were renamed in this revision but the content is similar to its predecessor.

Requirements of a successful software user documentation
This standard advocates that a successful software user documentation is "the result of proper audience identification, thoughtful software and document design, and good writing style, in addition to the structure, content, and format requirements addressed by this standard."

Overall structure
A user documentation set may consist of one or more documents each of which may be one or more volumes. Well-structured documentation makes information available where it is needed without redundancy.

When a document addresses audiences with different needs one of this structures should be used:
 * Separate sections devoted to the needs of specific audiences.
 * Separate documents or document sets for each specific audience.

This standard differentiates two documentation usage modes (instructional or reference). When a document contains both modes, the two should be clearly distinguishable, either by separating them into different sections or by a different formatting.
 * Instructional mode: In this mode sections are organized to facilitate learning. Procedures are structured according to the user’s tasks, related tasks are grouped in the same section and simpler more common, or initial tasks are presented before more complex, less utilized, or subsequent tasks.
 * Reference mode: In this mode documentation is arranged to facilitate random access to individual units of information. For example, a list of software commands or error messages should be arranged alphabetically.

Critical information should be placed in a prominent location in the documentation. General warnings or cautions that apply throughout the use of the software or documentation should appear in the initial components. Specific warnings and cautions should appear on the same page or screen and immediately before the procedure or step that requires care.

Content
The following table enumerates required and optional structural, content, and format components of a good user documentation. The components may be arranged in this order in printed documentation.

Each individual document should be structured to begin with identification data, followed by a table of contents and an introduction; that is, the introduction is the first chapter or topic of the document.

Format
The documentation format includes the selected electronic or print media and presentation conventions for stylistic, typographic, and graphic elements.

If the software being documented has accessibility features that allow disabled people to use it, so must the documentation.

Consistency is a key component for a good software user documentation. Documentation should use consistent terminology. Special formatting used for highlighting important information or to identify new or changed content should also be consistent throughout the document. Similar material, such as sets of instructions, should be presented in a consistent format.

The size of the printed documentation or the equipment and software required to access the electronic documentation should be consistent with the capacity of the expected users’ work environment.

The user should be able to use the software and read the documentation simultaneously. Online documentation should be available for display at any time while the user is using the software.

Both printed and electronic documentation must be legible to the user. Font size, style and color must be chosen carefully and be legible against the expected background color. Electronic documentation should remain legible even if the user decides apply zoom or resize the window.