Part 1Easy to use

Image

Ease of use is very broad. Some people equate the term with usability, which they consider as broad as quality itself. Here we limit ease of use to the primary characteristics that determine whether users can actually apply the information. We distinguish this ability from being able to find and understand the information.

Chapter 2. Task orientation

Write for the intended audience

Present information from the user's point of view

Indicate a practical reason for information

Relate details to a task where appropriate

Provide only a necessary amount of conceptual information in task topics

Focus on real tasks, not product ...

Get Developing Quality Technical Information: A Handbook for Writers and Editors, Second Edition now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.