IEEE HomeSearch IEEE ShopWeb Account Contact IEEE IEEE
MembershipPublicationsServicesStandardsConferencesCareers/Jobs
IEEE-SA IEEE-SA Member Area Search our standards database for Abstract, Sponsor, Status, Contact,Ordering and Historical information. IEEE-SA Standards Association
Products & ServicesIEEE-SA MembershipStandards DevelopmentNews & InformationnavFillerHOMEHOME Icon

IEEE Std 1063-2001 IEEE Standard for Software User Documentation -Description

Abstract: Minimum requirements for the structure, information content, and format of user documentation, including both printed and electronic documents used in the work environment by users of systems containing software, are provided in this standard.

Keywords: online help, software user documentation, user manual

Content +

  • 1. Overview
    • 1.1 Scope
    • 1.2 Purpose
    • 1.3 Organization of the standard
    • 1.4 Candidate uses
  • 2. Definitions
  • 3. Structure of software user documentation
    • 3.1 Overall structure of documentation
    • 3.2 Initial components
    • 3.3 Placement of critical information
  • 4. Information content of software user documentation
    • 4.1 Completeness of information
    • 4.2 Accuracy of information
    • 4.3 Content of identification data
    • 4.4 Information for use of the documentation
    • 4.5 Concept of operations
    • 4.6 Information for general use of the software
    • 4.7 Information for procedures and tutorials
    • 4.8 Information on software commands
    • 4.9 Information on error messages and problem resolution
    • 4.10 Information on terminology
    • 4.11 Information on related information sources
  • 5. Format of software user documentation
    • 5.1 Consistency of terminology and formats
    • 5.2 Use of printed or electronic formats
    • 5.3 Legibility
    • 5.4 Formats for warnings, cautions, and notes
    • 5.5 Format for instructions
    • 5.6 Formats for representing user interface elements
    • 5.7 Formats for documentation features for accessing information
      • 5.7.1 Table of contents
      • 5.7.2 List of illustrations
      • 5.7.3 Index
      • 5.7.4 Search capability
    • 5.8 Formats for features for navigation
    • 5.9 Formats for illustrations
  • Annex A Bibliography
  • Annex B Indexing software user documentation

links: [Standard Status] - [Purchase] - [PDF*] - [Software Engineering Collection - Description]

available for Standards Online Software Engineering Collection subscribers only

spacer

Copyright ©2004 IEEE-SA
Contact IEEE-SA
(m.v.rodriguez@ieee.org)
URL: http://standards.ieee.org/reading/ieee/std_public/description/se/1063-2001_desc.html

spacer