Written by Sue ArkinApril 7, 2014

Quick Writing Tip: Don’t Add Images Until the Text is Done

Here’s a quick writing tip for user manuals: don’t add your images to the manual until you’re done writing your text. This has two advantages. The first is that when you add images one at a time over the long course of writing a manual, it’s easy to overdo it. When you add them all […]

Written by Sue ArkinFebruary 15, 2014February 26, 2014

TMI: The Expert Fallacy

The natural assumption of most software companies is that an application intended for experts in the field doesn’t need to explain anything beyond the interface. The user is supposed to know the work-flow and terms at least as well as the manual’s writer. But the reality is that many people are trained in the field […]

Tested Writing

Software Testing and Technical Writing by Sue Arkin

Category: User Manuals

Quick Writing Tip: Don’t Add Images Until the Text is Done

TMI: The Expert Fallacy