This PR provides a rewrite of the readme file, applying the improvements mentioned in the issue.
This will create a new commit in order to revert the existing changes.
