Add explanation of the promises feature to the docs.

I don't know how to rebuild the HTML docs though :-/