proposal to more explicitly explain the meaning of :ready
merged with master and resolved conflict due to small markup changes
Merge pull request #14 from wvdemeer/meaning-of-ready

Proposal: More explicitly explain the meaning of :ready
approved in call 4