DOC : whole bunch of documentation clean up

I think this entire block above needs to be indented, doesn't it?