I’d Rather Be Writing - Tom Johnson

Documentation Honesty and Poor User Interfaces — An Ethical Dilemma?

Sunday, December 21st, 2008 Posted in Technical Writing | 4 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..

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

Tuesday, September 9th, 2008 Posted in Technical Writing | 20 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 | 1 Comment »

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