We talk to Terry Hopper of Middlestone about modelling business processes, process mapping, the relationship between processes and procedures, and Business Process Model and Notation (BPNM).



This is a recording of a presentation from the February 2018 London Content Strategy Meetup

What's the deal about structured content?

"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 it promises to give its adopters, the different standards, and the challenges that come with using structured writing."



We look at using sequential art/comics/graphic novels in business. We discuss:

  • What is a comic?
  • Examples of comics used in a business context
  • Why use a comic?
  • Tools and resources you can use if you have no drawing skills
  • How to structure the story


Google on Google Chrome - comic book

Kubernetes, powered by Google Cloud comic

Scott McCloud: The visual magic of comics | TED Talk


Will Eisner's M-16 Rifle Manual

The Content Twins (content strategy graphic novel)

The DITA Man (the business benefits of DITA graphic novel)

The CEO and the technical communicator (making the business case for technical documentation graphic novel)


Comic Life Magic

Google Storyboard

Adobe e-Learning Assets


Cherryleaf creates instructional content that helps people use a product or complete a task. It can stop them getting stuck, frustrated and making mistakes. See the Cherryleaf website for more information. 


We look at one way the Institute of Scientific and Technical Communicators (ISTC) used to promote technical communication at the University of Cambridge's Careers fair. 

Lego TIE Striker™ Microfighter

Video - What is technical communication?


Please rate the Cherryleaf Podcast on iTunes

Cherryleaf website

January 13, 2018

26. Equipped for elearning?

We look at the equipment you can use for creating elearning content. 

Zoom H6 recorder




Cherryleaf training courses


It’s not quite 2018 yet, but here are our predictions for technical communication in 2018 and beyond. We also look back at the predictions we made for 2017.


Predictions for technical communication in 2017 and beyond

Five predictions for technical communication in 2016 and beyond

Docs Like Code - Interview with Anne Gentle

Every Page is Page One - Interview with Mark Baker at UAEurope 2017 

Cherryleaf website


Flickr image by byronv2 

November 14, 2017

22. If not DITA, then what?

We look at the pros and cons of using the DITA standard, and the alternatives.


Every Page is Page One - Interview with Mark Baker at UAEurope 2017

Interview with Tony Self - UAEurope 17


We look at some of the best books to read on technical writing.


Single Sourcing, Kurt Ament

Ron Blicq and Lisa Moretto

Minimalism Beyond the Nurnberg Funnel, John Carroll

Lean for Practitioners, Mark Eaton

Managing Your Documentation Projects, JoAnn Hackos

Information Development, JoAnn Hackos

Modern Technical Writing, Andrew Etter

Docs Like Code, Anne Gentle

Current Practices and Trends in Technical and Professional Communication, Stephen Crabbe

The Language of Technical Communication, Ray Gallon

The Language of Content Srategy, Rahel Bailie

Every Page is Page One, Mark Baker

Automate the Boring Stuff with Python, Al Sweigart

Don't Make me Think, Steve Krug

Rocket Surgery Made Easy, Steve Krug

Content Strategy: Connecting the Dots Between Business, Brand, and Benefits, Rahel Bailie and Noz Urbina

Content Design, Sarah Richards


We explore these questions from listeners:

  • What’s your opinion of Zendesk and Mindtouch? Someone in our company thinks it might be a good idea to explore the idea of moving our Help content  – have you heard of anyone doing this and then using it in a way of single sourcing etc? 
  • Our boss wants us to consider the idea of merging our Help content and our “Knowledge base” which is like articles/support troubleshooting etc. Whether this is our content going into the knowledge base or vice versa, we’re not sure in terms of direction. Do you have any opinions on merging article-based content like this into a Help Authoring tool or Help content into a “normal” website like that?


Just-In-Time Documentation: A Practical Guide to Agile Documentation

AI and chatbots in technical communication - A primer



Interview with Anne Gentle, author of Docs Like Code and Product Manager at Cisco. 

Interview by Ellis Pratt, Cherryleaf

Subscribe to Cherryleaf's newsletter

Cherryleaf training course – Advanced technical writing techniques

For comments and feedback: info@cherryleaf.com

Topics covered: 

  • What is docs as code?
  • Why do it?
  • When might this approach might be applicable?
  • The limitations
  • Docs like code in development sprints
  • Is it only for developer docs?
  • Do you you need to understand programming?
  • Why did you self publish?
  • The benefits of taking this approach
  • The future developments
  • Automating document builds

Links to topics mentioned:


Conversation and Community: The Social Web for Documentation

Troy Howard Documentarian, Super Genius at Twitter

http://codewerdz.org/ Repository analytics for code and docs

Matt Fleming on Twitter

Docs Like Code GitHub repository






Liquid scripting



Lunr Search Engine 

Solr (Search Engine)

Why we use a ‘docs as code’ approach for technical documentation Jen Lambourne, GDS, GOV.UK

The Definition of Done

Learn Python the Hard Way



GitHub Flavoured Markdown spec

XML Press


Building Docs Like Code - article

Travis CI 


Circle CI


Bash scripts

An Introduction to Static Site Generators

GitHub Pages 


Interview with David Farbey of the Institute of Scientific and Technical Communicators, about training, accreditation and CPD in technical communication.

We discuss:

  • Becoming a technical communicator is different from becoming a lawyer, doctor, developer or an accountant in that, in the UK, there is no standard career path from school. How does that affect the profession and starting a career?
  • What training, if any, do you need to be a technical communicator?
  • The ISTC's Professional Development and Recognition
  • Certifying technical communicators
  • The ISTC certified courses.
  • What does a undergraduate or post-graduate course offer someone?
  • Where does CPD fit into this?
  • What are we likely to see in the future with regards to training and certification?

Cherryleaf's ISTC accredited training course: https://www.cherryleaf.com/training/technical-author-basicinduction-training-course/ 

ISTC website: www.istc.org.uk

David's email: education@istc.org.uk 


We look at the job of a Technical Author/Technical Communicator, and how you can start your career.



Cherryleaf’s online Technical Author/technical writing course


Load more