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...


My book "Choose Your First Product" is available now.

It gives you 4 easy steps to find and validate a humble product idea.

Learn more.

(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.