Improve the documentation of the functions

In brief these changes:
* improve how the examples of the functions are formatted 
* change the example of the download function
* add a url to the description of the datasets function