[docs] [issue16665] doc for builtin hex() is poor

[Raymond Hettinger]

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 at python -> rhettinger
nosy: +rhettinger

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