[docs] [issue33887] doc Add TOC in Design and History FAQ

Raymond Hettinger report at bugs.python.org
Sun Jun 17 22:16:10 EDT 2018


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

Please don't fill-up the tracker with dozens of micro-PRs for tiny documentation changes of dubious benefit or occasional detriment.  On the balance, it isn't helpful to have a newcomer second-guess every little writing decision that has been made.  Ideally, we should focus on issues that are known to actually be confusing real users.  Also, it would be ideal to spend time learning the existing documentation norms.  

The little micro-edits each take time to discuss, review and apply or reject.  This eats into the small bits of spare time that the reviewers have and takes them away from other issues.

Perhaps you could channel your enthusiasm into reviewing other doc patches or open bugs.

----------
nosy: +rhettinger

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


More information about the docs mailing list