kbase / dts

A data transfer service
https://kbase.github.io/dts/
MIT License
0 stars 0 forks source link

Figure out a clever way to autogenerate openapi.yaml #55

Closed jeff-cohere closed 4 months ago

jeff-cohere commented 6 months ago

The file openapi.yaml, which is used to generate our static HTML REST API docs, is not particularly easy to write or navigate. And the Credit Engine schema's documentation is embedded in it, too, which introduces a source of volatility. It might be good for us to ponder ways of assembling this file from different pieces. A simple manually-run Python script might be good enough to get us what we want.

Interesting Things