From The Blog

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

Checking Links in Docs-As-Code Projects

Creating content requires accuracy as well as creativity and the ability to deliver. Working with docs-as-code gives a strong foundation and structure to work within, and means there’s a clear workflow where automation can be added to help us with the easy stuff, such as “do all these links work?”.

I really appreciate having the extra confidence and support of these types of tools, and having implemented them on multiple projects at this point, I thought I’d share my advice for anyone looking to do the same. Continue reading


Talks, Articles, Podcasts, and More

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
Slides

Open Source DocOps


FOSDEM, February 2024
Slides

Intro to OpenAPI


FOSDEM, February 2024
Speaker

Redocly and OpenAPI


APIs You Won't Hate, January 2024