DOC : whole bunch of documentation clean up

There is already a link just out of the diff range