Cover Page ofThe Mayfield Handbook of Technical & Scientific Writing
Table of ContentsWriting TimelineHelpCredits

Section 2.8.2

Documentation (Manuals)

The formal description of a mechanical system or a technical process is known as itsdocumentation. Documentation takes the form of technical and user manuals that accompanyvarious technological objects, materials, and processes. Electronic hardware, computers,chemicals, automobiles all are accompanied by descriptive documentation in the form of manuals.

Two kinds of documentation are required when products are sold: technical documentation and userdocumentation.

Manuals should be prepared with the object of making the information quickly available to theexpert or general reader. Keep the audience foremost in mind. In manuals, ease of finding and reading information is a priority. Hence manuals should containthese components:

Easy-to-use locating elements, such as tables of contents, indexes, and page headers

Useful big-picture and close-up diagrams that make it easy forthe reader to become familiar with the technology

Effective warnings against personal harm and cautions against harm to the equipment

Page designs that lay the material out effectively, with effectivelabeling, chunking, and white spaces

Clear manual arrangements into sections and chaptersorganized around important tasks

Simple, economical style, pared down to just what is needed

Consistent, well-designed terminology that keeps the reader focused on the task

Effective packages, with binders and covers designed for the working space in which the manualwill be used

Reference Link Text
## Documentation (Manuals) ##
Reference Link Text

[ Home | Table of Contents| Writing Timeline | Index |Help | Credits]

Copyright ©2001 The McGraw-Hill Companies. Any use is subject to the Terms of Use and Privacy Policy. McGraw-Hill Higher Education is one of the many fine businesses of
The McGraw-Hill Companies, Inc.
.
Corporate Link