364 updates to documentation

[minump]

Description

Updated documentation as per feedback.

Fixes #364

Review Time Estimate

Please give your idea of how soon this pull request needs to be reviewed by selecting one of the options below. This can be based on the criticality of the issue at hand and/or other relevant factors.

• [ ] Immediately
• [x] Within a week
• [ ] When possible

Type of changes

Please select a relevant option:

• [ ] Bug fix (non-breaking change which fixes an issue).
• [ ] New feature (non-breaking change which adds functionality).
• [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected).
• [x] Other (any another change that does not fall in one of the above categories.)

Checklist:

Please select all applicable options:

• [x] I have updated the CHANGELOG.
• [ ] I have performed a self-review of my own code.
• [ ] I have commented my code, particularly in hard-to-understand areas.
• [ ] My change requires updating the documentation.
• [ ] I have made necessary changes to the documentation.
• [ ] I have added tests related to my changes.
• [ ] My changes generate no new warnings.
• [ ] New and existing unit tests pass locally with my changes.
• [ ] Any dependent changes have been merged and published in downstream modules.

---