generate markdown document
podhmo opened this issue · comments
something like this https://gist.github.com/podhmo/fe0416719d565cee8781da70feaf69a6
- no API execution mechanism (read only)
- 1column
- permalink everywhere
- input/output with go's struct like expression
- copy and paste friendly (duplicated text is OK (e.g. the path of endpoints ), document is not DRY)
why input is not general openapi doc?
because it is easy that implements the subset instead of fullset
not support
- oneOf,anyOf,allOf
- explode in path parameters
- form data
- path.parameters (not operation.parameters)
- request, response components
TODO
- input example
- response headers