http://bugs.python.org/review/26267/diff/18046/Doc/library/uuid.rst File Doc/library/uuid.rst (right): http://bugs.python.org/review/26267/diff/18046/Doc/library/uuid.rst#newcode5... Doc/library/uuid.rst:51: .. describe:: str(uuid) It would be better to be less verbose here. This can go after the "Exactly one of hex, bytes, bytes_le, fields [...]" paragraph in the uuid.UUID() documentation. http://bugs.python.org/review/26267/diff/18046/Doc/library/uuid.rst#newcode5... Doc/library/uuid.rst:56: .. describe:: uuid1 == uuid2 Same as above. See datetime or decimal documentations for an example of how to document comparison operations. http://bugs.python.org/review/26267/