DOC: revise documentation (WIP)

1 job for dev in 1 minute and 10 seconds (queued for 3 seconds)
Status Job ID Name Coverage
  Test
passed #36813
validate

00:01:10