Hey Sam, really digging this!
Just a quick tip. I noticed that you have another post in this series:
You could also edit both this post and the other to include "series: whatever name you'd like for your series" in the front matter. This'll connect your two posts with a cool little dot scroll option at the top of each post that lets the reader easily flip between posts in the series.
Umm yeah, no idea what this option is actually called, so chose to call it a "dot scroll" ... but anyway, it looks like this:
... in my posts here & here.
Not a must-do, just a nice-to-have in case you wanna!
Side note, not sure if you've ever read Kin Lane (apievangelist.com/) but I'm thinking you might dig some of his stuff. He talks about APIs from a number of angles - design, politics, you name it... though he's currently on hiatus. Still, he's extremely prolific and has a backlog of entries that go on for ages. Definitely worth a read.
We're a place where coders share, stay up-to-date and grow their careers.
We strive for transparency and don't collect excess data.