Yeah. I think that nails it. If we had something like an openapi specification or Swagger spec

1. the reference guide could be generated
2. We can verify/test code and check for breaking changes
3. Generate and verify clients from the api specification
4. Build/contribute additional tooling around the specification