update documentation and more routing specs