This MR includes a number of documentation updates and cleanup to address items in issue #107. This does not address all those issues.
...but don't actually update (`poetry lock --no-update`).
