Suggestions for the documentation

Proposed changes for README.rdoc