1152 fix route map

fixes #1152. Shortened the docs and improved a few things