Conversation
Mpdreamz
left a comment
There was a problem hiding this comment.
Great validation! Good to know V2 OpenAPi works as intended in practice too.
For question 2, these will need to be exposed as products in that case (cloud-billing, manager-intake).
We should not embed OpenAPi in git, we should fetch them from our mirror. Some more work is needed to do so.
This was something I was pondering in the context of release notes as well -- do we need a "cloud" product ID or is it better to be able to apply multiple product Ids to a single item? I think in both the changelogs and APIs the latter is more accurate and clear (i.e. I think these billing APIs apply to both Cloud Serverless and Cloud Hosted but not Cloud Enterprise). |
This PR copies the current Cloud Billing, Cloud ECE, and Cloud Hosted API docs into this repo as a test of the docs in #2879
It proves that the tooling can handle Swagger (OpenAPI v2) documents. Open issues and questions:
x-displayNamevalues or show the descriptions).Steps to test
docs-builder serve -p /path/to/docs-builder/docshttp://localhost:3000/api/cloud-hosted/