Add info about running plt.show()

[Jellevanderwerff]

Our plotting functions call fig.show(), but not plt.show(). If running in interactive mode, in a notebook etc., the plot will show. If not, plt.show() must be called.

We need to mention this in the documentation:

• In the usage examples
• In the docstrings
• In the docstrings examples