Updates docs and readme

Some better organization of the routes doc and updates to the readme.