doctests not working

[wdevazelhes]

In PR #152 I'll introduce some doctests. However, they seem to not be executed at least when I build the docs (if I change the results it throws no error when building the doc). But they should be executed somewhere

[bellet]

We should definitely make this work, as there are a few broken snippets in the doc