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