BS 7830:1996
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 design and preparation of on-screen documentation for users of application software
Hardcopy , PDF
19-06-2014
English
15-05-1996
Committees responsible
Foreword
Introduction
Section 1. General
Section 2. Overview
Process
Section 3. Objectives
Section 4. Planning and control
Section 5. Analysis
Section 6. Design
Section 7. Implementation
Guidelines
Section 8. Content
Section 9. Navigation
Section 10. Style
Section 11. Presentation
Tables
Table 1 Example access methods
Figures
1 Methods of delivering information to users
2 Structure of the standard
3 The process
4 The guidelines
5 The objectives phase
6 Example contents list for a Documentation Proposal
7 Planning and control
8 Example contents list for a Documentation Plan
9 The analysis phase
10 Example list of types of user
11 Example user hierarchy
12 Example task list
13 Example task hierarchy
14 Example mapping of users and tasks showing
learning stages
15 Example analysis of what information a user needs
16 Example information characteristics
17 Example usability goals
18 Example contents list for the Documentation
Requirements
19 The design phase
20 Example of allocating information to documentation
for an electronic mail system
21 Example of allocating information to documentation
for a wholesale banking system
22 Example designs for on-screen and paper
documentation
23 Example file structure for on-screen information
24 Example contents of a Documentation Specification
25 The implementation phase
26 Sequences of implementation activities
27 Example design for the contents of 'How to use Help'
28 Example of a task description with the elements
marked
29 Example field descriptions
30 Example function description for a product
module
31 Example function description for a spreadsheet
function
32 Example definition of a term
33 Example concept for a spreadsheet system
34 Example concept for a wholesale banking system
35 Example of a menu using icons and text for
navigation controls
36 Example of a menu displayed as lists
37 Example of a menu displaying two levels
38 Example of a menu using icons with an
illustration
39 Example of an index
40 Example of a contents list
41 Example of a scrolling topic
42 Example buttons for moving between topics
43 Example list of topics already viewed
44 Example of clarification information displayed
temporarily
45 Example of amplification information displayed
temporarily
46 Example of a task description with the writing
styles marked
47 Example instructions
48 Examples of facts as a description and an
instruction
49 Example of conditions presented as a table
50 Example of allocating types of information to types
of window
51 Tiled and overlapping windows
52 Example of a grid for task descriptions and
function descriptions
53 Example grid for field definitions
54 Examples of type sizes, word spacing and line
spacing
55 Example of a scrolling table where the headings
do not scroll
56 Examples of different icons used to indicate status
Annexes
A (informative) Process checklists
A.1 Objectives
A.2 Planning
A.3 Analysis
A.4 Design
A.5 Implementation
B (informative) Review checklists
B.1 Content checklist
B.2 Navigation checklist
B.3 Style checklist
B.4 Presentation checklist
C (informative) Evaluation
C.1 General
C.2 Procedure
C.3 Views
C.4 Qualities
C.5 Evaluation methods
D (informative) How to use this British Standard
E (informative) Bibliography
E.1 Reference books
E.2 Use of English
E.3 Preparing on-screen user documentation
E.4 Interface design
E.5 Ergonomics
Index
List of references
Gives advice about the the development of on-screen user documentation for application software. Gives guidelines for the content, navigation, style and presentation of the information.
Committee |
IST/15
|
DevelopmentNote |
Supersedes 95/643768 DC (10/2005) Inactive for the new design. (10/2011)
|
DocumentType |
Standard
|
Pages |
114
|
PublisherName |
British Standards Institution
|
Status |
Withdrawn
|
Supersedes |
Standards | Relationship |
AS/NZS 4598.2:1999 | Identical |
BS TICKIT GUIDE : ISSUE 5.5 | A GUIDE TO SOFTWARE QUALITY MANAGEMENT SYSTEM CONSTRUCTION AND CERTIFICATION TO ISO 9001:2000 |
IEEE 1063-2001 | IEEE Standard for Software User Documentation |
BS EN ISO 9001:2015 | Quality management systems. Requirements |
ISO/IEC 9126:1991 | Software enginnering Product quality |
BS EN 29241-1:1993 | General introductionErgonomic requirements for office work with visual display terminals (VDTs) |
ISO/IEC 12207:2008 | Systems and software engineering — Software life cycle processes |
BS EN 29241-3:1993 | Ergonomic requirements for office work with visual display terminals (VDTs) Visual display requirements |
BS EN 29241-2:1993 | Ergonomic requirements for office work with visual display terminals (VDTs) Guidance on task requirements |
BS ISO/IEC 12119:1994 | Information technology. Software packages. Quality requirements and testing |
BS 7649:1993 | Guide to the design and preparation of documentation for users of application software |
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.