Fix failing user test and endpoint.

Also making it more thorough.
Adding more complete documentation.

In addition to adding documentation at the sphinx layer, I added some
docstrings to make autodoc work. Additionally, I had to refactor some of the
constants to use functions. This removed the warnings and errors from the
documentation build.
Merge pull request #44 from girder/more-docs

Adding more complete sphinx documentation