The Tech Comm Manifesto

June 7th, 2010 by Sarah O'Keefe

My life in technical communication would be much easier if we all subscribed to these rules:

  1. Go beyond the obvious.
  2. Ignorance is not an asset.
  3. People do judge a book by its cover. Don’t give them the opportunity to assume you’re a blithering idiot.
  4. Your content may be special, but it does not need special formatting. Follow the style guide.
  5. Act like a professional, not like the lead character in Semicolons and Subservience.
  6. Editors improve your writing and not your ego. Deal with it.
  7. The tools you learned five years ago are obsolete. Learn the new tools. Repeat every five years.
  8. Clear, concise writing never goes out of style.

9 Responses to “The Tech Comm Manifesto”

  1. Gina Evans says:

    Hear, hear! Great list, all true.

  2. Walter Hanig says:

    9. Your reader is more important than you are.

  3. Bill Swallow says:

    Edit to #7: strike last sentence and replace with “Continuously.”

  4. Simon Bate says:

    10. Use the appropriate tool for the job, then use it appropriately.

  5. Lori Meyer says:

    A lot of common sense in these rules; thanks for posting.

  6. [...] CyberText Newsletter The official newsletter/blog of CyberText Consulting – technical communication specialists « Talking head or live person? The technical communicator’s manifesto June 30, 2010 The delightful Sarah O’Keefe (the lady with all the chocolates at the Scriptorium booth at technical writing conferences) has put together The Tech Comm Manifesto: http://www.scriptorium.com/blog/2010/06/the-tech-comm-manifesto.html [...]

  7. Wade Courtney says:

    Why is list a numbered list?

  8. Wade Courtney says:

    That shoule be: Why is the list a numbered list? tee hee

  9. @Wade I’m going with “For easy reference” because it sounds better than “because the number button was a few pixels closer than the bullet button”.

Leave a Reply