I stopped manually maintaining OpenAPI specs — here's what I did instead

It was a Monday morning. A partner pinged us because their integration had broken overnight. Turns...