Customer Support: 131 242

  • There are no items in your cart
We noticed you’re not on the correct regional site. Switch to our AMERICAS site for the best experience.
Dismiss alert

AS/NZS 4598.1:1999

Withdrawn
Withdrawn

A Withdrawn Standard is one, which is removed from sale, and its unique number can no longer be used. The Standard can be withdrawn and not replaced, or it can be withdrawn and replaced by a Standard with a different number.

Guide to the development of application software Software user documentation
Available format(s)

Hardcopy , PDF 1 User , PDF 3 Users , PDF 5 Users , PDF 9 Users

Withdrawn date

25-06-2021

Language(s)

English

Published date

05-08-1999

Preview

INTRODUCTIONSection 1 - General 1.1 Scope 1.2 Informative references 1.3 DefinitionsProcessSection 2 - Integrated design and development of software products 2.1 Integrated development stages 2.2 Responsibilities for documentation activities 2.3 Local standards and procedures 2.4 Documentation processes 2.5 Sequence of documentation activitiesSection 3 - Project objectives, requirements and constraints 3.1 General 3.2 Collect and interpret project requirements and constraintsSection 4 - Analysis 4.1 General 4.2 Collect details of users 4.3 Determine what documentation users need 4.4 Record users' needs for information 4.5 Produce the outline documentation planSection 5 - Planning 5.1 General 5.2 Design the content, structure and style of each document 5.3 Set the editorial standards 5.4 Design the physical presentation of each document 5.5 Design the complete package 5.6 Decide how the documents will be developed 5.7 Decide how the documents will be produced 5.8 Decide how the documents will be updated 5.9 Estimate costs 5.10 Prepare schedules 5.11 Revise the design 5.12 Write the documentation plan 5.13 Review the documentation planSection 6 - Development and review 6.1 General 6.2 Prepare and issue first draft 6.3 Check and review drafts 6.4 Prepare subsequent drafts 6.5 Validation and field trials 6.6 Prepare master pagesSection 7 - Production and distribution 7.1 General 7.2 Submit master pages for production 7.3 Package the documents and software 7.4 Check the finished documents and package 7.5 Archive the master versions 7.6 Distribute the productSection 8 - Evaluation and updating 8.1 General 8.2 Evaluate the documentation 8.3 Update the documentationDetailed DesignSection 9 - Document contents 9.1 General 9.2 Contents of awareness or appreciation documents 9.3 Contents of installation instructions 9.4 Contents of tutorials 9.5 Contents of quick reference documents 9.6 Contents of comprehensive reference documentsSection 10 - Document structures 10.1 General 10.2 Structure of awareness or appreciation documents 10.3 Structure of installation instructions 10.4 Structure of tutorial documents 10.5 Structure of quick reference documents 10.6 Structure of comprehensive reference documents 10.7 Numbering schemes for pages, sections, illustrations and tablesSection 11 - Document writing styles 11.1 General 11.2 Writing style for awareness and appreciation documents 11.3 Writing style for installation instructions 11.4 Writing style for tutorial documents 11.5 Writing style for quick reference documents 11.6 Writing style for comprehensive reference documents 11.7 Types of illustrationSection 12 - Document writing techniques 12.1 General 12.2 Writing techniques 12.3 Vocabulary 12.4 Technical termsSection 13 - Document presentation 13.1 General 13.2 Page layouts 13.3 Use of colour 13.4 Presentation of text 13.5 Presentation of lists, tables and notes 13.6 Presentation of illustrations 13.7 Special symbols and icons 13.8 Quality and durability of the finished documents 13.9 Binding 13.10 Packaging 13.11 Cover informationSection 14 - Document contents lists and indexes 14.1 General 14.2 Contents lists 14.3 IndexesAnnexesA (informative) - Bibliography A.1 Reference books A.2 Use of English A.3 Preparing user documentation A.4 TypographyB (informative) - Collected checklists B.1 Project objectives, requirements and constraints B.2 Analysis B.3 Planning B.4 Development and review B.5 Production and distributionIndex

Provides designers of application software with guidelines for the design and preparation of user documentation for application software covering what information users need, how to decide what information should be provided (on paper and on-screen) and how to prepare the relevant documentation. This Standard is identical with and has been reproduced from BS 7649:1993.

Committee
IT-015
DocumentType
Standard
ISBN
0 7337 2885 5
Pages
97
PublisherName
Standards Australia
Status
Withdrawn
Supersedes

Standards Relationship
BS 7649:1993 Identical

First published as AS/NZS 4598.1:1999.

AS 3897-1991 Information processing - Guidelines for the management of software documentation

AS/NZS 4598.2:1999 Guide to the development of application software On-screen documentation

View more information
$268.88
Including GST where applicable

Access your standards online with a subscription

Features

  • Simple online access to standards, technical information and regulations.

  • Critical updates of standards and customisable alerts and notifications.

  • Multi-user online standards collection: secure, flexible and cost effective.

Need help?
Call us on 131 242, then click here to start a Screen Sharing session
so we can help right away! Learn more