Merge branch 'documentation' into 'master'

write a new shiny and comprehensive documentation

See merge request !224
2 jobs for master in 38 minutes and 29 seconds (queued for 2 seconds)
Status Job ID Name Coverage
  Test
passed #2789
black

00:01:55

passed #2788
test

00:38:29

63.0%