expanded docs for handler and router

[skip ci]