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.

[cormander]

This looks interesting: https://www.npmjs.com/package/swagger-ui-express

[cormander]

Initial commit e9d23f9