Improve documentation

[Hawk777]

Summary of the PR

Fix an incorrect documentation statement. Clarify some documentation.

Requirements

Before submitting your PR, please make sure you addressed the following requirements:

• [X] All commits in this PR are signed (with git commit -s), and the commit message has max 60 characters for the summary and max 75 characters for each description line.
• [X] All added/changed functionality has a corresponding unit/integration test.
• [X] All added/changed public-facing functionality has entries in the "Upcoming Release" section of CHANGELOG.md (if no such section exists, please create one).
• [X] Any newly added unsafe code is properly documented.

[alindima]

@petreeftime please approve, so that I can merge this small PR