Reorganize the documentation

Will close issue #257 and #273 
And maybe we give this section a header

>
### Generating a URL in a Controller