doc: address pr17578 review feedback
Summary:
Comments and docstring changes only
This is a backport of Core PR17585 [1/5]
https://github.com/bitcoin/bitcoin/pull/17585/commits/c7654af6f830577a54df12b5d65df93532db0dc2
Test Plan: proof reading
Reviewers: #bitcoin_abc, majcosta
Reviewed By: #bitcoin_abc, majcosta
Differential Revision: https://reviews.bitcoinabc.org/D8700