To the Documentation Workgroup: Should we avoid addressing the user directly when writing docs? I believe this was up for discussion on python-dev last year, but I was unable to find it in the archives, so I guess my memory fails me. Also, I cannot find any recommendations regarding this in the devguide.
Outside of tutorials and howtos, we avoid addressing the reader as "you", instead using a style where the "you" is implied. Instead of saying: > If you want X, do Y. simply say: > To achieve X, do Y.
Does the Documentation WG have an opinion regarding this, or is it just up the personal preference of the various code owners and maintainers?
Personally, I’m aligned with Łukasz’ opinion
cc. @steven.daprano (as per discussion on bpo)