DOC : whole bunch of documentation clean up

Sorry… Yes, it isn't aligned with "This" and "things"