Topic-based writing: what is it, and why should I care?

In this episode of the Cherryleaf Podcast, we take a look at topic-based writing. We explore: What is a topic? Features of topics Why use topics? Why not use topics? Where can you use them? What happens if you don’t use it? Tools for topic-based writing What do you need to know Interacting with others

New training course – Writing skills for developers

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 »

Using Hemingway on our website

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 »

How old are your readers?

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 »

Americanisms and Britishisms

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 »