Many organizations give rise to in-house tools or reorient commercially-available tools for their own use. These tools should congregate documented so they are of deplete to others in the organization.
If this documentation is not created or is ailing written, it costs you twice:
* The key set someone back (attributed to any bad alcohol detail) […]
OVERVIEW
A good User Document includes sections on how to set up, use, and care for the product. However, to create a great User Document , the technical writer should use the Persona, generated in the analysis of the User/Reader, to create the topics for the most useful section of the User Document. This […]
OVERVIEW
Searches in User Documents (manuals, etc.) often fail because the Reader uses different words for a concept than the author uses. Since the Reader’s words do not appear in the document, the document search mechanism cannot find them, resulting in frustration. This article describes a User-friendly technique for improving searches, without having to change […]
OVERVIEW
Stop confusing your Reader with the words you use. Your Reader is trying his/her best to understand how your product works without having to figure out your writing. Here are some writing guidelines to help you stop baffling your Reader.
SAME CONCEPT: SAME WORDS
User Documents are not meant to be entertaining. Do not try to be […]
Overview
Incomplete User Documents disappoint your Readers. Two attitudes of many Technical Writers result in incomplete User Documents. These two attitudes are:
. “Everyone Knows That”, and
. “The User Can Figure It Out”
This article describes these attitudes and presents methods for overcoming them. The result is more effective User Documents and more satisfied Users.
1. “Everyone Knows That”
The […]
