Add examples for routes

Routes need more extensive inline documentation and examples so they can be used more easily.

See #3 (closed) and !8 (merged).