Improve the README and fix the docs badge link

Merged Ribbon requested to merge improve-readme into master

Merge request reports