Comments, Whitespace and Typehinting

Also fixed a bit of the MD.