documentation: rewrite README and remove TODO

2 jobs for documentation in 23 minutes and 7 seconds (queued for 7 seconds)
Status Job ID Name Coverage
  Test
passed #2577
black

00:01:50

passed #2576
test

00:23:07

63.0%