[issue45677] [doc] improve sqlite3 docs

Erlend E. Aasland report at bugs.python.org
Sun Oct 31 06:43:37 EDT 2021


Erlend E. Aasland <erlend.aasland at innova.no> added the comment:

> 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.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue45677>
_______________________________________


More information about the Python-bugs-list mailing list