DOC : whole bunch of documentation clean up

Do we really want this in our documentation? :(