From Designing APIs with Swagger and OpenAPI by Josh Poenlat

This article covers:

•  Informal vs Formal descriptions

•  Learning about the OpenAPI specification

•  Learning about YAML ( as a easier-to-write JSON )

•  Describing our first GET operation