updates readme with documentations links
fixes url protocol for gh-pages submodule