* fixing some of the routes so that they are consistent.
 * adding some documentation for the API.