Add all explanation in docstring of example modules

[aroberge]

For the documentation of the examples, instead of having a separate .rst file with content (other than an automodule directive), include all the required text in the module docstring. This will make it possible for people perusing the code to have all the relevant information in a single place.