Which type of platform is best for developer documentation?

At the Write The Docs event in London last night, Gergely Imreh presented Resin.io’s approach to customer-driven docs – documentation as self service support. Resin.io is a software company that provides Linux containers to the Internet of Things. It sees itself as a support-driven organisation, and so documentation is very important to them. The discussions at the… Read more »

Is documentation a dirty word?

Daryl Colquhoun has written an article in tcWorld about the international standard ISO/IEC/IEEE 26512. He explained the standard is going to be revised and renamed: from “Systems and software engineering – Requirements for managers of user documentation” to “Systems and software engineering – Requirements for managers of information for users”. The reason for this, he states, is… Read more »

Reducing the reading age for our website

Following on from James Mathewson’s  presentation at Content Strategy 17, we’ve been reflecting on Cherryleaf’s main website, and the improvements we could make to it. One thing we have started to do is reduce the reading age for the content. Reading age measures are also, in effect, readability measures. So any improvements also benefit people… Read more »

How IBM uses audience intent modelling

I spoke at, and attended, the Content Strategy Applied 2017 conference last week. One of the keynote speakers, James Mathewson, provided a fascinating description of how IBM uses audience intent modelling to map its content plans. By doing this IBM is able to align its content with the buying cycles for their target personas. This planning… Read more »

Technical writing builds trust in your organisation

I spoke at, and attended, the Content Strategy Applied 2017 conference last week. One of the keynote speakers, Madi Weland Solomon, explored what the impact of content has on users, and the trends that will inform content strategy in the near future. She said one of the key challenges for organisations will be dealing with the loss… Read more »