updated documentation of routes, started doc for object types.