Another chance to preach OpenAPI to documentarians, a repeat of the APItheDocs talk but this time for the lovely WriteTheDocs audience. There’s a video of the talk, but I was even more charmed by the sketchnote from the session:
Taking an opportunity to hang out with the Laravel/PHP crowd and present design-first APIs in general, with OpenAPI in particular! View Design-first APIs with OpenAPI on Notist.
Always a pleasure to be at APItheDocs and I was very pleased to present this talk specifically for documentarians and other information specialists on understanding OpenAPI. View OpenAPI for Documentarians on Notist.
Giving talks about OpenAPI often means lots and lots of slides of YAML. In fact, one of my talks even contains a “warning, contains yaml” slide! If you aren’t a professional yaml developer, it can be difficult to digest and … Continue reading →
Improve your API experience with better API descriptions using summary, description and externalDocs appropriately. Use markdown, and these simple writing structure tips to improve your OpenAPI files – and the resulting documentation. Continue reading →
Delighted to see EndpointCon return to AppDevCon this year, and even more delighted to be accepted as a speaker! View API Governance without tears on Notist.
Loved the crowd and the whole Developer Experience track at the excellent WTF is SRE conference! View API Experience is Developer Experience on Notist.
I’m a firm fan of a design-first approach to building APIs, and advocate for it at every opportunity. Repeatedly. Design-first means that an API change starts in the OpenAPI description, gets reviewed and approved by the stakeholders, and then gets … Continue reading →