Few documentation fixes for 1.7 branch

This PR contains a couple of reference fixes and also links compiling documentation to the readme file.