Documentation fixes, referring to IPython with correct capitalisation :-)
Trying to improve the formatting to appease flake8 build process.  Must align?