DOC : whole bunch of documentation clean up

Maybe add a link to the numpy doc format documentation?