Part 3: Easy to understand
Users appreciate technical information that can be understood with as little effort as possible. After all, people don’t read technical information for pleasure; they read it to accomplish a task quickly. Information that is easy to understand is clear, unambiguous, concrete, and consistent where it counts.
Use words as only one part of speech
Use words with a clear meaning
Get Developing Quality Technical Information: A Handbook for Writers and Editors, Third 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.