Welcome! I'm Lorna Jane Mitchell: a software engineer and author based in the UK, with a particular interest in APIs, open standards, and open source. I've written several books on programming and API design, and these days spend a good deal of my time on standards work; I sit on the Technical Steering Committee for the OpenAPI Initiative and on the board of OpenUK. Over the years I've been an engineer, a writer, a conference speaker, and an open source maintainer, usually all at once.
On this site you'll find my blog, a record of talks and writing I've done elsewhere, and my contact details. I'm happy to hear from others in the industry, whether that's about articles, podcasts, speaking, or open source collaboration.
-
Describe Your API For Agents
18 November 2026
Read moreFor agents to use APIs effectively, they need clear context on the API and how to navigate it. Every API needs a full, structured, supporting document that covers in detail every endpoint, parameter, and possible response. These guardrails allow agents to find their way and call APIs without unexpected side effects or token-maxxing surprises. The big surprise is: that agent standard already exists, and its name is OpenAPI.
-
dataValue and serializedValue in OpenAPI 3.2
31 August 2026
Read moreBest practice in APIs always includes the advice to include examples. In older versions of OpenAPI (3.1 and earlier), that was simple for JSON data but a little bit unclear for other formats whether to describe the data structure or to show the actual data that would be transferred. Help is at hand in OpenAPI 3.2 where the new fields dataValue and serializedValue mean you can do whichever makes most sense - or both!
-
From Wordpress to Static Site Generator
20 August 2026
Read moreThis blog has been online for 20 years, and I've tried to spend a lot more time writing content than fiddling with the toolchain or theme for it, because too many blogs never see the light of day because the theme is somehow never ready. It started life on Textpattern, spent a few years on Serendipity, and ended up in 2011 migrated to Wordpress.
Recent posts
-
API Standards for AI Agents
14 October 2026 — Nordic APIs Summit
-
API Standards for AI Agents
07 October 2026 — APIDays London
-
OpenAPI Upgrades
07 October 2026 — APIDays London