Technical Writing: 10 Mistakes you don't wanna make

These are not the most common mistakes -- but they may be the nastiest.

  1. Avoid personal pronouns, and reminiscence:
  2. Avoid stale or dated metaphors:
  3. Beware of similes:
  4. Avoid Florid Speech:
  5. Avoid religious topics:
  6. Don't assume your reader to be technically ignorant:
  7. Avoid offensive pronouns:
  8. Avoid Personalization (anthropomorphism) :
  9. Cut overlarge words; break over-long sentences:
  10. Avoid the "not un-" construct (this example courtesy of Orwell) :

Actually, I quite like a few of those... Particular metphors and similes...

 

I'm currently writing a book about how to build your first product. If you want to build your first product, please sign up to be notified when the book is available.

(By the way, I read every comment and often respond.)

Your comment, please?

Your Name
Your Url (optional)
Note: I may edit, reuse or delete your comment. Don't be mean.