Document public REST API

[juliencruz]

Javadoc comments need to be developed for all API worthy classes. REST documentation should be included in this Javadoc documentation to produce REST API documentation.

[jloveland]

What do you think about swagger or enunciate?

I like the look of swagger because it provides a nice UI and Editor

[juliencruz]

I have seen some docs before from Swagger and would like to use that if possible. Shouldn't be too difficult to add these in.