Merge branch 'doc/updates_and_fixes' into 'master'

Doc: updates and fixes

Closes #27, #25, and #24

See merge request !44
3 jobs for master in 37 minutes and 50 seconds (queued for 3 seconds)