Improve README.md flow

Improve the way in which the README.md file flows when read.
Merge pull request #3353 from psgs/readme-update

Improve README.md flow