Raymond Hettinger added the comment:

-1 for the suggested text.

For some of the points, a couple examples will do a better job of explaining 
hex() that trying to write-out the full code specification in prose.  

Overly wordy documentation is harder to use than something short that addresses 
the primary use case.  

Also, the suggested "notes" editorialize and venture into the realm of personal 
coding preferences.

----------
assignee: docs@python -> rhettinger
nosy: +rhettinger

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue16665>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to