Docs: Review & improve published documentation

[scottgerring]

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

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

[scottgerring]

@saurabhsharma001, are you interested in this one?

[saurabhsharma001]

Yes. I will start on this.