Close #19011: Add documentation on some of the non-standard Enum behavior.

Issues such as iterating and containment on Enum classes, why Enum member
instances do not show up on other Enum members, and how __new__ should
be used.