[FIX] Adjust documentation from #115 and #119

[treee111]

This PR…

• adjust documentation based on the both PR's

Considerations and implementations

This is the main body of the PR, and varies massively by PR. A simple PR may have a single sentence here, others may have multiple paragraphs, diagrams, etc.

{...}

How to test

1. ...
2. ...

Pull Request Checklist

• [ ] Reviewed the Contributing Guidelines
  • Especially the Pull-Requests section
• [ ] Commits (and commit-messages) are understandable
• [ ] Tested with macOS / Linux
• [ ] Tested with Windows