Clarify the behavior of promise.yield. Fixes #164
Merge pull request #165 from skiadas/doc-fixes

Clarify the behavior of promise.yield. Fixes #164