From The Blog

Selectively ignore lines in git diff

I have a things-as-code project that outputs mostly text-based formats, but a lot of them. To keep an eye on consistency, I rebuild all the outputs and dump them into a local git repository so I can very easily diff to spot any changes – which was fine until we added a build timestamp, so every file looks changed on every run! This post is about ignoring the matching line with git diff -I. Continue reading

Git renames are not renames

Git renames are not renames
I consider myself pretty git-confident, I’ve worked with it a lot, taught it, been a git consultant, run engineering and various things-as-code teams. This week I had a spectactular git problem where merging one branch into another produced changes that didn’t exist on either branch. Turns out, renaming directories in a monorepo with multiple almost-identical boilerplate documentation files comes with surprises… Continue reading

Manage Diagrams in AsciiDoc on GitHub

Manage Diagrams in AsciiDoc on GitHub
I use a lot of asciidoc these days for work documentation (and I love it) and I’ve been so happy that GitHub renders it when you view a repository in the web browser, just like it does for Markdown and ReStructuredText. BUT what GitHub does not do is render the image types that asciidoc does so even though I’m working with asciidoc and PlantUML, and the asciidoc tools render those diagrams nicely in PDF and HTML output – GitHub’s rendering doesn’t. So here’s a quick overview of how I handle those repositories. Continue reading

Talks, Articles, Podcasts, and More

Video

API Standards for AI Agents


Nordic APIs Livecast, January 2026
Slides

What’s new in OpenAPI 3.2


APIDays London, September 2025
Article

OpenAPI: How to handle file management


The New Stack, April 2025
Slides

OpenAPI for Web Developers


PHP UK Conference, February 2025
Article

New OpenAPI Standards


The New Stack, February 2025
Video

Panel: Maintaining Open Source Software


State of Open, February 2025