root-systems / dogstack

:dog: :dog: :dog: a popular-choice grab-bag framework for teams working on production web apps
https://dogstack.js.org/
25 stars 7 forks source link

Auto Api Documentation with json schema #57

Open danalexilewis opened 7 years ago

danalexilewis commented 7 years ago

In diving into the json schema ecosystem I came across doca, a json schema driven api documentation.

I was quite excited about this.

https://github.com/cloudflare/doca/

any thoughts on this.

ahdinosaur commented 7 years ago

yeah!

also feathers-swagger

from https://github.com/dogstack/dogstack-example/issues/11#issuecomment-294393510,

swagger and raml support json schemas: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#schemaObject, https://github.com/raml-org/raml-spec/blob/master/versions/raml-10/raml-10.md/#using-xml-and-json-schema