API Documentation

[vsreekanti]

Document all the external facing APIs and use something like Swagger to automatically generate API docs for us.

[tarpdalton]

For storing/displaying ground's documentation, we can create github pages by storing them in the docs folder on the master branch.
Publish Your Project Documentation with GitHub Pages

[vsreekanti]

@tarpdalton With the Swagger implementation, is it possible to have the framework generate standalone HTML files? If so, could we separate that code out for #19?

[vsreekanti]

http://www.ground-context.org/ground/api/ Any idea why this is happening?

[tarpdalton]

It is because the request (to get the JSON) is from ground-context.org not ground-context.github.io/ground/api. I might be able to change the CORS setting or something to allow cross origin requests

[tarpdalton]

I'll see if I can fix it with Crossorigin.me or cors.io Since GitHub has cors disabled

[vsreekanti]

Great, thanks James!