Add explanation of the promises feature to the docs.
"Merge pull request #1156 from domenic/gh-pages-promises\n\nAdd explanation of the promises feature to the docs."

* domenic/gh-pages-promises:
  Add explanation of the promises feature to the docs.
Add documentation for promises (close #1156)