Fixes issue #611 update documentation
Was already merged in Bitbucket before import, marked as merged by the import user
- Starting 'issue611-update-documentation' branch.
- Minor: typos + formatting.
- Added release checklist for the Tycho build + documentation updates.
- Updated the readme file.