Improve documentation of safety constraints on hashable objects (#505)

* Clarify documentation for hashing

Makes clear that hashable objects need to be deeply immutable, in
practice even if not in theory.

Closes #503 .

* Use simple past tense in docs
3 files changed