Docs: Review & improve published documentation

[scottgerring]

trafficstars

What were you searching in the docs?

The documentation site could use a complete review for clarity, accuracy, and content. The other powertool documentation sites - in particular, powertools for python - may provide inspiration on what we are missing, or how we can do better.

Is this related to an existing documentation section?

No response

How can we improve?

Review & improve documentation

Got a suggestion in mind?

No response

Acknowledgment

• [X] I understand the final update might be different from my proposed suggestion, or refused.