[docs] Tweak README

Fix our repository URL on GitHub.
Add variable definition for Promise doc. #1651
Merge branch 'live-docs' into dev-master