Merge branch 'enhancement/improve_docs' into 'master'

Revised docs.

See merge request !24
5 jobs for master in 50 minutes and 59 seconds (queued for 2 seconds)