lornajane angel icon

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.

    Recent posts


  1. Describe Your API For Agents


    For 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.

    Read more

  2. dataValue and serializedValue in OpenAPI 3.2


    Best 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!

    Read more

  3. From Wordpress to Static Site Generator


    This 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.

    Read more

    More LornaJane


  1. slides API Standards for AI Agents

    — Nordic APIs Summit

  2. slides API Standards for AI Agents

    — APIDays London

  3. slides OpenAPI Upgrades

    — APIDays London