The API docs should be more easily to access and readable than what a GitHub readme can do.

Should move the docs to use Swagger and then generate using Slate. This should be automated with Travis where possible, and either hosted on GitHub pages or my own server if needed.