added some documentation to the routes which is used by Lout when
generating the API docs