• About
  • Contact
  • Presentations
  • WordPress Consulting
  • Advertising
  • Podcasts
  • Jobs

  • The Case of the Stolen Documentation

    Wednesday, January 6th, 2010 Posted in Technical Writing | 11 Comments »

    Some months ago I created a half a dozen quick reference guides for an application that would have a potential audience of thousands of users (after it cleared the beta ... Read more..

    Notes Watching Senior Users at the Computer

    Friday, March 6th, 2009 Posted in Technical Writing | 9 Comments »

    Sometimes the audience for my help consists of seniors in the range of 60 to 85 years old. The other night I attended an orientation session with users to introduce ... Read more..

    Documentation Honesty and Poor User Interfaces — An Ethical Dilemma?

    Sunday, December 21st, 2008 Posted in Technical Writing | 5 Comments »

    Rilynn from New England writes, Tom, I notice that a lot of companies use release notes to post a list of defects (bug) that were fixed with the corresponding software release. This ... Read more..

    Coding Horror: How to Write Technical Documentation

    Monday, October 20th, 2008 Posted in Uncategorized | No Comments »

    Coding Horror: How to Write Technical Documentation. Read more..

    How Much Should You Document? Everything? Strategies for an Agile Environment

    Tuesday, September 9th, 2008 Posted in Technical Writing | 21 Comments »

    In a recent IT Author podcast ("Documentation and Agile Development"), Alistair Christie and Graham Campbell talk about agile development and its impact on documentation. One consequence of working in an ... Read more..

    Interesting Technique for Discovering Software Changes and Building Rapport with developers

    Saturday, December 15th, 2007 Posted in Technical Writing | 2 Comments »

    You know the typical scenario -- the technical writer is the last one to be notified of changes to the application (be it interface or functionality), and developers hate reviewing ... Read more..