DOC : whole bunch of documentation clean up

provides