From 0 to OpenAPI: Describing a 10-year old API with OpenAPI @ GitHub
Marc-Andre Giroux, GitHub
Andrew Hoglund, GitHub
It's no secret that design-first approaches using specifications like OpenAPI are a wonderful way to facilitate API development. However, not everyone is lucky enough to start from scratch. How do you handle describing a 10-year old API with close to 1000 resources?
This talk is the story of how we approached the seemingly insurmountable challenge of describing the GitHub REST API v3 using OpenAPI.