[docs] [issue18280] Documentation is too personalized
report at bugs.python.org
Sun Jun 23 02:37:00 CEST 2013
A.M. Kuchling added the comment:
I've looked through the matches. "I/O" and the -I command-line switch are false positives. Many references in the FAQ ("How do I do X?"), but those don't need to be fixed.
I think personalized references are most problematic when they're expressing uncertainty ("I don't know if we implement all of the spec") or opinions. Sentences like "When I run this command under Linux, I see..." could be rewritten as "When *you* run this command...", but they don't seem worth fixing to me.
Files with personalized text are:
Python tracker <report at bugs.python.org>
More information about the docs