OpenAPI docs rendered in browser using https://github.com/stoplightio/elements
(Note the gotcha: the browser caches the YAML files even if they have changed, open dev console in the browser to mitigate.)
summary
is the short descriptiondescription
is a longer description (supports Markdown)
The following script was used to generate the OpenAPI Spec YAML structure
ruby openapi.rb