Moved more docs from the wiki to yardoc.
Merge pull request #188 from ruby-concurrency/docs

Moved more docs from the wiki to yardoc.