Clarity |
"Everything that can be thought at all can be thought clearly. Everything that can be said can be said clearly."
- Ludwig Wittgenstein
In order to write clearly, set your thoughts in order. What do you want to say? What content organization will help say it most clearly? Review your outline, and revise it, before you begin writing. One technical writing problem is the poor quality of existing documents that you have to work from. Arcane terminology, circular definitions, unfamiliar acronyms, and missing instructions drag writers and users through a realm of technobabble. Another problem is jargon. Jargon is verbal shorthand used by people who are conversant with a subject. But if you are new to the field, jargon is a major obstacle. It’s an even bigger problem if you are not fluent in English. Learning software is hard enough without wading through a quagmire of acronyms in an unfamiliar language. Marketing catch phrases poison instructional communication, bloat your text, and do not age well. Users remember less and perform worse after viewing technical content that contained marketing phrases. The implication was that users mentally argued with the marketing message, distracting from the instructional content. |
![]()
|
|