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
Category: writing
What’s the deal about structured content?
This is a recording of a presentation from the February 2018 London Content Strategy Meetup. “Content can often seem like jelly – messy and hard to manage. In this presentation, we’ll look at whether you can reduce this messiness through structured writing. In this overview of the topic, we’ll explore what is structured writing, what… Read more »
New web page on structured authoring
While preparing for the upcoming presentation on structured authoring, we realised we didn’t have anything on that subject on the Cherryleaf website. To fix that, we’ve added a new page to the site, on structured authoring. We plan to add a recording of the presentation, and some examples, after the event.
What is the minimal amount of user documentation you should write?
In researching what developers wanted to learn about writing documentation for users, the most common issue related to how much, or how little, they should write. One developer said: “I would want to know what is the minimum I should write. If you can persuade me what is the necessity of each thing I’m capturing, and… 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 »