➜

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 erlendaasland
Recipients docs@python, erlendaasland, steven.daprano
Date 2021-10-31.10:43:37
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1635677017.39.0.276571271187.issue45677@roundup.psfhosted.org>
In-reply-to
Content 
> What is wrong with addressing the reader as "you"?

I remember this was discussed on python-dev last year (?). IIRC, the majority was in favour of changing the documentation to avoid addressing the reader personally. Let us ask the Documentation Workgroup over at Discourse. I'll create a topic.

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

Sorry, that was a language glitch; I'm not a native english speaker :) _Use_ an affirmative tone is of course correct.
History
Date User Action Args
2021-10-31 10:43:37erlendaaslandsetrecipients: + erlendaasland, steven.daprano, docs@python
2021-10-31 10:43:37erlendaaslandsetmessageid: <1635677017.39.0.276571271187.issue45677@roundup.psfhosted.org>
2021-10-31 10:43:37erlendaaslandlinkissue45677 messages
2021-10-31 10:43:37erlendaaslandcreate