Slides

Design-First is better than API-First


PHP[TEK], May 2019
My ideas around API design are always growing and changing, but I’ve definitely gone from API-first, to Docs-first, to now Spec-first when I work with APIs. I took the opportunity to cover some of the design choices for starting a new API project from scratch, and some of my favourite approaches to common problems.

View Design First is Better than API First on Notist.

Butterfly

Text Markup to PDF with rst2pdf

I’m an accidental maintainer of a python project: it’s rst2pdf which is a brilliant tool that I use for all my slide decks and other documents.

Butterfly

Intro to OpenAPI Spec

Describing your API opens the door to wonder and magic – and documentation of course. This talk is from the Tool the Docs room at FOSDEM.