DOC : whole bunch of documentation clean up

themselves is one word.