doc: fixed typos and formatting issues in documentation.

[fredbi]

• fixed README
• re-aligned ROADMAP
• fixed typos
• relinted markdown & godoc (excl. generated)

Change type

Please select: 🆕 New feature or enhancement|🔧 Bug fix'|📃 Documentation update

Short description

Fixes

Full description

Checklist

• I have signed all my commits with my name and email (see DCO. This does not require a PGP-signed commit
• I have rebased and squashed my work, so only one commit remains
• I have added tests to cover my changes.
• I have properly enriched go doc comments in code.
• I have properly documented any breaking change.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 91.32%. Comparing base (9b92774) to head (19188a9).
⚠️ Report is 2 commits behind head on master.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@            Coverage Diff             @@
##           master      #67      +/-   ##
==========================================
- Coverage   91.33%   91.32%   -0.02%     
==========================================
  Files          91       91              
  Lines       11925    11925              
==========================================
- Hits        10892    10890       -2     
- Misses        820      822       +2     
  Partials      213      213              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.