From The Blog

Pretty-print JSON with jq

Wrangling some document conversion the other day, I ended up in a situation where I had the JSON I needed, but in a completely unreadable format. Luckily, this problem is very easily fixable …. when you know how. So today’s post is a quick recap on how I did that using jq, a very handy command-line tool for working with JSON. For the impatient, here’s the command:

cat posts.json | jq "." > better.json

In this post we’ll look at the data I started with and what the different bits of the command to do help. Continue reading

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


Talks, Articles, Podcasts, and More

Video

API Evangelist Conversation


API Evangelist Conversation, October 2024
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