DOC : whole bunch of documentation clean up

copy and paste text editing!