For all these examples in the docstrings, I think you should include:

```
.. plot::
   :include-source:

etc.
```

so that the source code is visible (it's interesting for the user to see how you made the plot)