As the science-denial perpetrated omnishambles of 2020 continues, COVID-19 rages on whilst Europe gets hit by deadly storms and flash floods, wildfires are big enough to be called “gigafires”, the Arctic refuses to freeze for the first time on record, thousands are displaced by flooding in Vietnam, and the only countries on track to hit the Paris Agreement are The Gambia and Morocco.

Instead of hoping those in power decide to suddenly start listening to science and implementing solutions to solve the climate crisis, many of us are doing what we can to make change. …


Some API developers use API descriptions to plan the interface of an API before building it, which is known as the “API design first” workflow. Others build the API then generate (or manually produce) API descriptions later, which is the “code-first” workflow. We wrote recently to help get you up to speed on the differences, but how do you actually create these API descriptions?

Many of these API descriptions (OpenAPI, JSON Schema, or GraphQL Schemas) involve writing out a bunch of special keywords in YAML, JSON, or another text language. Neither the design-first or code-first crew…


Some API developers use API descriptions to plan the interface of an API before building it, which is known as the “API design first” workflow. Others build the API then generate (or manually produce) API descriptions later, which is the “code-first” workflow. We wrote recently to help get you up to speed on the differences, but how do you actually create these API descriptions?

Many of these API descriptions (OpenAPI, JSON Schema, or GraphQL Schemas) involve writing out a bunch of special keywords in YAML, JSON, or another text language. Neither the design-first or code-first crew…


Are you a couple of miles (or days) from the nearest bike shop? If you’re like me, and enjoy creative problem solving, then this is a fun opportunity to think outside the box! Here’s some stunts I had to pull over the last year of bike touring/packing around Europe.

Smashed Cable Guide

I lost the ability to shift in the hills near Mertola, Portugal. It wasn’t the shifter, the cable itself was refusing to move. …


Some API developers use API descriptions to plan the interface of an API before building it, which is known as the “API design first” workflow. Others build the API then generate (or manually produce) API descriptions later, which is the “code-first” workflow. We wrote recently to help get you up to speed on the differences, but how do you actually create these API descriptions?

Many of these API descriptions (OpenAPI, JSON Schema, or GraphQL Schemas) involve writing out a bunch of special keywords in YAML, JSON, or another text language. …


Companies are stepping up to go carbon neutral ( or even carbon negative), and the number of big companies offering remote work is on the rise, but remote work in the States is still only 3–5%. With most of the world ( especially the U.S.) desperately needing to sort its carbon footprint out, remote working might just be a big piece of the puzzle.

Not being forced to center your entire life around getting to a specific place every Monday to Friday opens up a lot of opportunities to improve the quality of life, massively lower your carbon…


OpenAPI using an “extended subset” of JSON Schema has caused confusion in the API space since before I had even heard of OpenAPI. Thanks to a lot of hard work from a lot of people over the last 6 months, OpenAPI v3.1 will in fact solve this problem, and there was much rejoicing.

For anyone who’s not read a million words on the topic from me on this topic already, I was talking about the divergence in 2017. It feels like forever ago now that I was just Googling around trying to figure out which API description format to recommend…


The first few months of the year is peak travel time for Northern Hemisphere dwellers, as they try to get south for better weather. If you’re in America, you might consider a week in Miami, Puerto Rico, or the Caribbean, and if you’re in Europe you might be tempted by the budget flights to southern Spain, the Canary Islands, Turkey, etc. In the past I would have joined you, but 2020 is a year for doing things differently, and with it being January, let’s look at one New Years resolution worth sticking to: going flight free.

Flight Free 2020 campaigns…


Going from fundraising 70,000 trees in summer, to being injured and unable to do shit, meant I had to think outside the box in order to keep the reforestation going.

Meet my Cannondale CAAD8. Back in 2015 I was back in the UK, between jobs, and between US visas. I grabbed this bike to mush out a little west country tour, putting ~1000 miles on the clock before it sat in the parents shed for four years.

I decided it was time to put it to good use.

Bidding started at 3,000 trees (about £300 as it’s roughly 10p…


Over the years I’ve used about 20 different web application frameworks (tool-kits for making server-side applications), contributed to a few, and maintained a couple of popular ones. I’ve got a bit of a theory that many developers are introduced to new methodologies as and when their framework deliver it to them.

Whilst this might sound like cargo-cult culture, I get it, developers are busy people. User manuals showing how to do DDD, TDD, Event Sourcing, or whatever, is much easier to understand in the context of a framework you’re already familiar with.

These days many frameworks are either primarily designed…

Phil Sturgeon

Building API design tools @stoplightio , teaching at @apisyouwonthate, and cycling around Europe raising funding for reforestation and climate action.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store