Examples in doc

add examples to the sphinx documentation

Note that all the examples will need a header (see example_averaging).