[docs] Tweak README

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