Improving slideuments – a makeover

We’ve been posting some videos on YouTube that provide tips relating to business and technical communication. Our most recent video is about slideuments. A slideument is a cross between a slide deck and a document. In this video, we go through how a slideument can be improved to make it easier to read as a document…. Read more »

Rewriting a procedure so it’s clearer – A walkthrough

This is a walkthrough of how to improve an existing procedure so it’s easier to understand. We take an old Brigade Order from a Fire and Rescue Service and go through the process of reorganising the content and re-writing the text.  

How you could make your Help topics appear at the top of the Search Engines

  We’ve just uploaded a video on “How you could make your Help topics appear at the top of the Search Engines”. It’s about Schema.org/HowTo, which Google is promoting as the way to get instructional content to appear in the snippets box. There is a longer version of this video in Cherryleaf’s Advanced Technical Writing… Read more »

Importing API reference documentation into a MadCap Flare project

Last year, we blogged about creating an API documentation portal using MadCap Flare (see also: Example of API documentation portal using MadCap Flare). Since then, a number of people have contacted us to ask for more details on ways to do this. We’ve put together a video outlining the different approaches and issues. This approach can work with… Read more »