Guidelines for Developing Instructions

Guidelines for Developing Instructions

by Kay Inaba, Stuart O. Parsons, Robert J. Smillie
     
 

ISBN-10: 041532209X

ISBN-13: 9780415322096

Pub. Date: 03/28/2004

Publisher: Taylor & Francis

Confusing, inadequate instructions for setting up and using consumer products are not only unhelpful, but potentially dangerous. They may contain wrong information, poor warnings, and no pictures or illustrations. Standards are either non-existent or little known, even though the U.S. government has developed and tested standards for the past thirty years. This

Overview

Confusing, inadequate instructions for setting up and using consumer products are not only unhelpful, but potentially dangerous. They may contain wrong information, poor warnings, and no pictures or illustrations. Standards are either non-existent or little known, even though the U.S. government has developed and tested standards for the past thirty years. This book presents a set of guidelines written by The Human Factors and Ergonomics Society that have been tested by human factor specialists. This expert advice is applicable to writing assembly procedures, operational procedures, and user, shop, and repair manuals.

Product Details

ISBN-13:
9780415322096
Publisher:
Taylor & Francis
Publication date:
03/28/2004
Edition description:
New Edition
Pages:
160
Product dimensions:
5.90(w) x 8.80(h) x 0.50(d)

Table of Contents

INTRODUCTION

GENERAL CONSIDERATIONS
Expected Mode of Use
Basic Units of Instructions
Considerations for Packaging Information
Components of Instructions

GENERAL PRESENTATION PRINCIPLES
Summary of Principles
Short-Term Memory
Consistency and Fixed Syntax
Text-Graphic
Figure-to-Ground Ratio
Sequence
Multilingual Format

INFORMATION TO PLAN THE WORK
General
Configuration
Prerequisite Conditions
Safety
Help Required
Tools, Equipment, and Supplies
Table of

GRAPHICS
Locators
Detailed View
Types of Graphics
Captions
Callouts
Application Guidelines

LANGUAGE CONTROL
Rules for Command Verbs
Command Verb List
Command Verb Dictionary
Non-Command Verbs
Nouns and Nomenclature
Other Parts of Speech
Abbreviations

TEXT AND FORMAT SPECIFICATIONS AND RULES
Headings
Command Steps
Sequence of Tasks and Steps
Callouts in Text
Sub-Procedures (Procedures within Procedures)
Tables to Supplement Instructions
Guidance and Routing Information (Notes)

PREPARING INSTRUCTIONS
Set Ground Rules
Gather Source Materials
Conduct Analysis
Design
Write and Edit
Conduct a User Test

SPECIAL CONSIDERATIONS FOR MAINTENANCE
The Inherent Structure of Maintenance
Special Analysis for Troubleshooting
Format for Troubleshooting Instructions

APPENDIX: CHECKLIST FOR DEVELOPING EASY-TO-USE INSTRUCTIONS
Planning Information
Graphics
Language Control
Text and Format
Preparing the Instructions
REFERENCES
INDEX

Customer Reviews

Average Review:

Write a Review

and post it to your social network

     

Most Helpful Customer Reviews

See all customer reviews >