improvements to install docs
Merge pull request #1588 from tiagojsag/install_docs

improvements to install docs