From The Blog

Open Standards for APIs

I work or have worked with APIs of all sorts of standards, sometimes many standards at once – or none. Each standard exists for a purpose and might be a great fit, or a terrible fit for other purposes. Today’s post is a recap of some of the common API standards around and what you need to know about each one. Continue reading

Lint APIs with Redocly CLI

API governance needs good tooling, and rules that fit – so today’s post covers both.

Fun fact: I work at Redocly and had used the tool for years, but recently realised that I have a post about a different tool in the archives of my blog, but no Redocly post. So here’s the Lorna-recommended version of OpenAPI linting with Redocly CLI. Continue reading

API Description Pipelines

API Description Pipelines title, in an AI-generated frame of cartoon pipes
Working on API tools, I get to see inside lots of different organisations’ API projects and processes. Every scenario is different, but a common theme is that many companies use a more complicated API description workflow than you see in conference slide decks! Without sharing any one organisation’s secrets, this article shares a rundown of some typical steps that might show up in an API description pipeline. Continue reading

Talks, Articles, Podcasts, and More

Slides

DevOps Your Docs


WriteTheDocs Atlantic, September 2024
Slides

API Description Pipelines


APIDays London, September 2024
Slides

AsyncAPI governance the easy way


APIDays London, September 2024
Slides

Write Great Tech Content


WordCamp Whitley Bay, July 2024
Speaker

Voices from UK Tech


Chinchilla Squeaks, June 2024
Slides

Developer Experience in Open Source Projects


State of Open Con, February 2024