[Sprint] Update coding guidelines wrt documentation

This notes that we are using numpydoc going forward.

Also notes that (as discussed at BOF) we should add simple examples for high-level plotting functions to the Example section.