Today, we’ve released our latest training course – Writing skills for developers. The course teaches developers the key skills of technical writing for software user documentation. Although it would be better for a professional technical communicator to write the end user documentation, for some organisations, this isn’t always possible. It is for developers who: Need a solid… Read more »
Last week, we used the Hemingway app to highlight any unclear pages on our main website. The app highlighted four pages where we’d used the passive voice or very long sentences. The first inclination was to think our readers are cleverer, our content is more technical, it’s not possible to rewrite those parts. We found, of course, we… Read more »
In his newsletter last week, internet psychologist Graham Jones mentioned research that had looked into what makes some web content more shareable than others. The researchers had analysed articles on Medium, and found there were several key factors. One was the length of the content – around 1,800 words ( approximately 7 minutes reading time). Another was… Read more »
There are user documentation projects where we are asked to write in American English instead of British English, and generally this is a pretty straightforward exercise for us. However, when I speak at conferences in the USA, delegates sometimes ask me afterwards what I meant by a particular expression. For example, I was recently asked… Read more »
Yesterday, I went on walk to celebrate the life of Richard White, and I was asked by someone on the walk how we tackle procedures writing projects. They asked two great questions: Do you use templates, and which tools do you use? I thought it might be useful to describe our approach.