documentation: rewrite README and remove TODO

Status Job ID Name Coverage
  Test
passed #2577
black

00:01:50

passed #2576
test

00:23:07

63.0%