doc: improve README

Nicolas Chauvat requested to merge topic/default/doc into branch/default

Merge request reports