Dr. Dobbs: 10 Things Tech Writers Want Developers to Know
- Crisp, Clear, Concise Communication
- Precise Instructions
- Avoid OON (Overheating the Optic Nerve)
- Purge Needless Politeness
- Accurate, Thorough, Timely Reviews
- Reasonable Edits
- Revere Visuals
- Spell Out Acronyms
- Be Monolingual
- Expect Translation
- Use the same term or expression for the same concept.
- Avoid expressions that are culture specific.
- Use plain words.
- Use vertical lists.
- Use active voice wherever possible.
Das sind doch mehr als 10? Naja.
