Issue #12067: Recommend that hash and equality be consistent

vadmium · vadmium · commit 8dbb0ca57343 · 2017-01-29T10:00:23.000Z
diff --git a/Doc/reference/expressions.rst b/Doc/reference/expressions.rst
@@ -1255,6 +1255,10 @@ some consistency rules, if possible:
   sequences, but not to sets or mappings). See also the
   :func:`~functools.total_ordering` decorator.
 
+* The :func:`hash` result should be consistent with equality.
+  Objects that are equal should either have the same hash value,
+  or be marked as unhashable.
+
 Python does not enforce these consistency rules. In fact, the not-a-number
 values are an example for not following these rules.
 
