updated docs for api and router
merged in linting changes with docs changes