Made all descriptions of the examples docstrings.
The examples are parsed to be included in the docs, so the way in which
their description is given should be consistent.