Document API via annotations

[cormander]

As a developer I want to document the API endpoints in-line to the code so that I can easily keep the API documentation up to date and so that people integrating with the API can do so easily.

This feature is done when:

• A framework to annotate node.js code is chosen
• Basic documentation of each endpoint is completed.