* add django-rest-swagger to document the public API
* add markdown to allow using markdown in the docstrings that show up in swagger
* setup an initial swagger config with docs available at /api/docs

* Write up an initial pass for the API views' documentation. Includes job
  descriptions as well as example requests, request types and formats, and
  example responses.

* NB: The example responses make the docstrings incredibly lengthy. While they
  appear nicely in Swagger under <details> elements, we may need to consider
  declaring them outside the views file