From The Blog

Preview OpenAPI as HTML using Scalar

The API DevTools space is alive and well with lots of new and exciting products popping up all the time. I’ve been especially impressed by the new tools in the docs space, but some of the options are less practical for use as quick human-friendly OpenAPI renderings or previews to use during API development. My current favourite in this space is Scalar because I can get an HTML file to easily include in a build or share with others. It’s a bit of a hack though, so I thought I’d share… Continue reading

Presenting with pdfpc

My slide deck tool ( rst2pdf ) produces PDFs, and I use pdfpc to present the PDF slides. It shows the current and next slides, my notes, a timer, and it probably does other things too that I don’t use! I’ve used it for years but it was really designed for “in real world” presenting with one or two screens. Recently I discovered it also supports some great options for remote presentations, but I had to look up how to do that so here are my notes (mostly in case I need to look it up 1 minute before I go on stage again!!). Continue reading

Querying the GitHub GraphQL API

In a recent project around open source contributors, I wanted to take a look at which projects a particular user (actually a few of them, but I wrote a wrapper to repeat the process for each handle) maintains. GitHub doesn’t show this maintainer relationship, so instead I used the v4 GraphQL API and looked at pull request comments on repositories that the user has access to. I’m sharing my query and the Python script I used to make the API calls to. Continue reading

Talks, Articles, Podcasts, and More

Article

New OpenAPI Standards


The New Stack, February 2025
Video

Panel: Maintaining Open Source Software


State of Open, February 2025
Slides

OpenAPI Standards Landscape


FOSDEM, February 2025
Slides

Beyond the README


FOSDEM, February 2025
Slides

CLI Magic for Docs Projects


FOSDEM, February 2025
Speaker

The Not-Boring Tech Writer


Not-Boring Tech Writer, January 2025