Message405352
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. |
|
Date |
User |
Action |
Args |
2021-10-29 22:39:33 | steven.daprano | set | recipients:
+ steven.daprano, docs@python, erlendaasland |
2021-10-29 22:39:33 | steven.daprano | set | messageid: <1635547173.08.0.017488286733.issue45677@roundup.psfhosted.org> |
2021-10-29 22:39:33 | steven.daprano | link | issue45677 messages |
2021-10-29 22:39:33 | steven.daprano | create | |
|