Open Knowledge Format: What it means for technical documentation

graphic titled “Open Knowledge Format (OKF): What it means for technical documentation”, showing three connected Markdown-style document cards with YAML metadata, a central knowledge graph icon, and a subtle AI network illustration.

Could technical documentation become the knowledge layer for AI? This month, Google Cloud has introduced the Open Knowledge Format (OKF). It’s an open specification for packaging organisational knowledge in a form that both people and AI agents can use. An OKF collection is essentially a directory of Markdown files. Each file contains a small amount… Read more »

Podcast 60: Google adds rich results support for how-to content

In this episode of the Cherryleaf Podcast, we look at Google’s announcement to support and promote rich, how-to structured data in Google Search and the Google Assistant. Transcript Hello and welcome to the latest episode of the Cherryleaf Podcast. In this episode we’re going to look at a recent announcement by Google (it was also on the Google Blog). We’ll provide a link… Read more »

Microsoft publishes its REST API Design Guidelines

Microsoft has published  its REST API Design Guidelines to the API community. According to Gareth Jones, Principal API Architect, who announced its release: “The effort got started from hearing two key points of feedback from customers: It should be easier to get started with Microsoft APIs – Developers wanted to be able to run the curl tool… Read more »

Writing troubleshooting topics

It’s a fair bet that the introduction of the new Troubleshooting information type into the DITA 1.3 technical authoring standard will affect how all Technical Authors write troubleshooting topics, regardless of whether they use DITA or not. That’s because the proposed elements for troubleshooting topics make good sense, and it offers a standardised approach to writing… Read more »