Fix rst syntax in the README file

and slightly improve a few points.

Jenkins job DOBJS/gitlab-builds #268 succeeded .
See Console Output and Coverage Report for more details.

merged manually