OpenAPI for Documentarians
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.
Search Results for: api
Visualise OpenAPI with Blockly
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
Tips for better documentation with OpenAPI
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
API governance without tears
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.
API Experience is Developer Experience
Loved the crowd and the whole Developer Experience track at the excellent WTF is SRE conference! View API Experience is Developer Experience on Notist.
Improve Existing OpenAPI Descriptions
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
AsyncAPI and Spectral
Erik and I took our conversation about open standards and open source tools into the open on the Make APIs Work Podcast
Intro to AsyncAPI for Apache Kafka
Fun presentation and live demo at ApacheCon about AsyncAPI and using it with Apache Kafka (there will be a video at some point too). View Introduction to AsyncAPI for Apache Kafka on Notist.
AsyncAPI for Kafka
Fun talk (with a demo that I had to re-record later!) about AsyncAPI and Kafka for the lovely people at the Stockholm meetup for Kafka. Video available here: https://videos.confluent.io/watch/hzjXP8QmLtYRNPukNFUu2D? View Introduction to AsyncAPI on Notist.
Measuring Repo Community Health with GitHub’s API
Python script to call the GitHub API and get the stars count and community health of public repos. Continue reading