DOC : whole bunch of documentation clean up

:-1: on using IPython magics here.