There was an APIs track at FOSDEM this year, and I was delighted to open proceedings with an OpenAPI talk. The room was FULL so I hope we get to do it again some time!! View Introduction to OpenAPI on … Continue reading →
First time as a guest on the APIs you won’t hate podcast, chatting with Phil Sturgeon about what’s going on at Redocly, what’s happening in OpenAPI, and what’s coming up in the next release of OpenAPI, codenamed moonwalk. Episode page:
I’ve been thinking about API linting lately, partly because I work on a tool for API linting in my day job, and partly because I get quite a lot of questions from teams wanting to improve their API quality. The … Continue reading →
Use overlayjs to add x-openai-isConsequential flags for OpenAI to your existing OpenAPI description. This post explains the process and shows the commands to use. Continue reading →
I’ve heard a variety of bad advice (and some untruths!) regarding how to version your OpenAPI description lately. Rather than dig into those, instead I’ll share my opinion on how I like to version API descriptions in my own projects. … Continue reading →
I talk to a lot of people about their API lifecycles and processes, and one thing that has value in almost every case is immediate documentation preview for all updates to an OpenAPI description. The time it takes to set … Continue reading →
Another chance to preach OpenAPI to documentarians, a repeat of the APItheDocs talk but this time for the lovely WriteTheDocs audience. There’s a video of the talk, but I was even more charmed by the sketchnote from the session:
Taking an opportunity to hang out with the Laravel/PHP crowd and present design-first APIs in general, with OpenAPI in particular! View Design-first APIs with OpenAPI on Notist.