Technical Documentation Know-How
Resources for creating technical documentation, with a focus on software documentation and software user assistance
Do you write technical documentation? Here you can find know-how, tools, and links that will inspire you to design and write clear, concise, user-friendly manuals, online help files, screencasts, and other forms of user assistance.
User assistance bridges the gap between what the user already knows and what the user needs to know.
Many people in charge believe that writing technical documentation doesn’t require any special qualifications.
From the technical point of view, this is true. Appropriate authoring software generates neat user manuals and online help files with a click of a button.
The didactical side, however, is much more challenging. It’s no coincidence that so many people hate reading manuals and thus fail to use even simple products. This happens when a manual doesn’t reflect how users think, and when a manual presumes prior knowledge that users don’t have.
The know-how of writing plain user assistance that every user can understand is the ability to bridge the gap between the users’ prior knowledge and the knowledge required to use the product. User assistance shouldn’t challenge the reader. Instead, it should build up confidence, motivate the user to explore the product, and guide the user along the shortest way possible.
When planning to create new user manuals or online help files, or when reviewing existing technical documentation, you may find the following checklists useful:
To help you find suitable authoring tools, I’ve compiled a number of market overviews of useful software. The lists include tools to create and edit user manuals, online help files, and screencasts, as well as a number of other working aids for technical writers and translators.
Additionally, I’ve included a number of lists of useful web sites and recommended books. This is a collection of the resources that I use myself in my daily work as a technical writer.
You can find the links within the navigation area on the left.
I’ll also be happy to and to user manuals, online help files, and screencasts for you.