refactored code and starting to implement url route parsing
revised documentation to reflect API changes