[docs] [issue13515] Consistent documentation practices for security concerns and considerations

Nick Coghlan report at bugs.python.org
Thu Dec 1 12:46:58 CET 2011


Nick Coghlan <ncoghlan at gmail.com> added the comment:

While I acknowledge the point (it's the reason I *didn't* remove those warnings in my recent major update to the subprocess docs), Raymond's right that scattering warnings everywhere in the docs for modules like subprocess isn't the right answer either. For a lot of things people use those modules for (i.e. private scripts with no untrusted user input) the warnings are excessive.

There's only so much we can do to protect novice programmers being given tasks beyond their experience, and only so much readability we should sacrifice in the name of educating people about general programming issues that aren't specific to Python.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue13515>
_______________________________________


More information about the docs mailing list