-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.