docstrings in examples and tests

Examples are still a bit "dry" - they would benefit a lot from a short docstring (at their beginning) to explain in a few words what they are computing / benchmarking.
Same for tests: a minimal docstring for each would be nice.