[issue13386] Document documentation conventions for optional args

[Raymond Hettinger]

Raymond Hettinger added the comment:

Please don't add a new notation that makes the docs less readable than they are now.  For the most part, the existing docs have done a great job communicating how to use our functions.  Please don't undo 20 years of tradition because it bugs you.

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

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