User guide

This is an old revision of this page, as edited by 212.219.56.214 (talk) at 09:16, 4 January 2007. The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.

A user guide, also commonly known as a manual, is a technical communication document intended to give assistance to people using a particular system. It is usually written by a technical writer, although user guides could be written by programmers, product or project managers, or other technical staff, particularly in smaller companies.

User guides are most commonly associated with electronic goods, computer hardware and software.

Most user guides contain both a written guide and the associated images. In the case of computer applications it is usual to include screenshots of how the program should look, and hardware manuals often include clear, simplified diagrams. The language is written to match up with the intended audience with jargon kept to a minimum or explained thoroughly.

Contents

The usual sections of a user manual often include:

  • A preface, containing details of related documents and information on how to best use the user guide
  • A contents page
  • A guide on how to use at least the main functions of the system
  • A troubleshooting section detailing possible errors or problems that may occur along with how to fix them
  • A FAQ (Frequently Asked Questions)
  • Where to find further help and contact details
  • A glossary and, for larger documents, an index

Car and owner´s manual

See also