Tag Archives: technical writing

Please release me from release notes

I have an admission to make. I detest software release notes. Let me be clear: I am all in favour of keeping customers informed about the latest enhancements to a product, and understand that a new software release is a … Continue reading

Posted in technical writing | Tagged , , | 14 Comments

How much does it cost to NOT write a user guide?

Ivan Walsh recently published an article called How Much Does It Cost To Write a User Guide? Like all Ivan’s articles this was very clear and sensible piece, and it explained all the different factors involved in determining the price … Continue reading

Posted in technical writing | Tagged , , | 5 Comments

Addressing one mistake in agile adoption

The company I work for is very keen on introducing agile methods across its software development department, and this has inevitably caused much discussion. Due to staff shortages I have been working as the technical writer on multiple software projects … Continue reading

Posted in technical writing | Tagged , | 7 Comments

Mind the gap

I commute to work every day on the London Underground, known familiarly to Londoners and visitors alike as “the tube”. The tube network doesn’t always work as well as it could, and recently there was a very disruptive strike (with … Continue reading

Posted in information design, technical writing | Tagged , , , | 4 Comments

Asking the right questions

When you’re a technical communicator you need to know what are the right questions to ask – and who to address those questions to. This is the topic I’d been thinking about when my very good friends atĀ Firehead Ltd. asked … Continue reading

Posted in technical writing | Tagged , | 1 Comment

On being “influential”

I was surprised and flattered to find myself included this week on MindTouch’s list of the Top 25 Most Influential Technical Communications Bloggers (and I have added a badge to this blog to prove it!). It’s a great honour to … Continue reading

Posted in technical writing | Tagged , , , | 1 Comment

Doc tasks in the sprint – for the first time

Although I’ve been part of an agile development team for the last few months, until recently my user documentation tasks have not been part of the sprint backlog. But this time, my tasks are on the board! (I realise that … Continue reading

Posted in technical writing | Tagged , | 3 Comments

Talking about Content Strategy at TCUK

I’m pleased to report that my proposal to speak at Technical Communications UK 2010 (TCUK) has been accepted. I’m going to speaking on the theme of Content Strategy for Everyone. I won’t be alone in following Kristina Halvorson’s exhortation to … Continue reading

Posted in content strategy, technical writing | Tagged , , , | 2 Comments