Podcast 104: Fixing broken developer portals

On the Cherryleaf Podcast, we look at some of the common content challenges organisations face with their developer portals, and ways to fix them. We also look at creating a friction log, and the complexity of banking related APIs. Transcript: This is the Cherryleaf podcast.  Hello and welcome to the Cherryleaf Podcast. We’re going to look at in this… Read more »

New Technical Author vacancies

We’ve added some new vacancies to the Cherryleaf website today: See: #4200 Lead Technical Author, APIs, WFH/Central London, circa £60K #4201 Contract Technical Author, APIs, WFH/Central London  

API documentation: the undiscovered country

Recording from UAEurope 2017 conference. With many software developers now spending their time developing APIs, there’s an increasing demand for API documentation writers. It’s a fast changing field, with emerging information design patterns and authoring tools. It’s also different from end user documentation, and this means many Technical Communicators are uncertain if and how they… Read more »

Reflections on last week’s mini-conference on documenting APIs

Last Friday, I attended and presented at the Write The Docs mini-conference on documenting APIs, held at the Government Digital Services (GDS) building in Holborn. My presentation was called “What makes Technical Communicators uneasy about API documentation, and what can we do about it?”, and there were a number of questions and comments regarding some of… Read more »

Content as an API – Google’s engineering documentation

Google’s Riona MacNamara presented at the Write The Docs North America conference on “Documentation, Disrupted: How Two Technical Writers Changed Google Engineering Culture“. In the video of the presentation below, Riona explains how she worked with a small team of writers and engineers to build a documentation platform in six months that is becoming a part of the… Read more »