This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author steven.daprano
Recipients docs@python, erlendaasland, steven.daprano
Date 2021-10-29.22:39:33
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1635547173.08.0.017488286733.issue45677@roundup.psfhosted.org>
In-reply-to
Content
What is wrong with addressing the reader as "you"?

Avoiding an affirmative tone goes directly against the style-guide you linked to, which recommends an affirmative (positive) tone:

"The documentation focuses on affirmatively stating what the language does..."

The alternative would be to take a negative tone, focusing on what the library doesn't do.
History
Date User Action Args
2021-10-29 22:39:33steven.dapranosetrecipients: + steven.daprano, docs@python, erlendaasland
2021-10-29 22:39:33steven.dapranosetmessageid: <1635547173.08.0.017488286733.issue45677@roundup.psfhosted.org>
2021-10-29 22:39:33steven.dapranolinkissue45677 messages
2021-10-29 22:39:33steven.dapranocreate