Use recommended format for comment annotations

See https://github.com/bbatsov/ruby-style-guide#comment-annotations.
Clean up comments
Update documentation
Merge pull request #128 from yous/patch-documentation

Update documentation