O'Reilly logo

Developing Quality Technical Information: A Handbook for Writers and Editors, Third Edition by Elizabeth Wilde, Shannon Rouiller, Eric Radzinski, Deirdre Longo, Moira McFadden Lanyi, Michelle Carey

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

Chapter 2. Developing quality technical information

The evolution in technical information isn’t just about delivery formats. It’s also about refining your ability to write meaningful, quality information.

In embedded contexts, when you’re constrained to a few words, you need to use those words as effectively as possible. How do you develop quality information with so few words? In short, by following the same techniques you use to write separate documentation:

1. Investigating and understanding:

• Users and their skills and knowledge

• Users’ goals, not to be confused with the tasks they do to achieve those goals

• Scenarios for achieving goals

• How the product helps users achieve goals

• Terms and concepts used in the industry

2. Applying ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required