Why technical reviews fail

Reading time: 3 mins

It’s a common topic, an oft repeated complaint, and one which has already had many many lines of advice written, and countless suggestions offered. So here’s a new slant. The reason most technical reviews fail is because of the writer, not the reviewer. It’s not because the reviewers couldn’t find the time, it’s not because…

Write the docs first

Reading time: 2 mins

I’m currently pondering a proposal, suggesting to our Dev team that we write the user documentation first, and then use that as the basis of what the product should deliver. This wouldn’t work for everyone but given that an XP environment encourages little (well, less) documentation than a more traditional ISO style project, then having…

Technical Writing Evolved

Reading time: 3 mins

The following is largely focussed on the software industry as that is where my experience lies. I’ve been an on/off member of the TechWR mailing list for many years now. I dip in and out of threads depending on my current work and knowledge levels. The membership of the list is fairly wide-ranging, with people…

Skill Set

Reading time: 2 mins

Without meaning to I seem to have taken some inspiration from this post, whilst I’m not directly offering a counterpoint, it’s worth a read. ~ Every trade or profession has a skill set, a unique set of talents that make one role different from another. For most people in the IT industry we all have…

Reading time: 2 mins

Day in, day outI work in the field of Technical Communications (which is full of poppies and grazing sheep… sorry…). Essentially, whilst I am a ‘team lead/manager’, I am mainly a technical author by trade. So what is a technical author? Basically it is someone who writes manuals. But, as with every other job, there…

CategoriesUncategorized