More documentation updates
diff --git a/docs/changelog.txt b/docs/changelog.txt
index 64ccd16..987f736 100644
--- a/docs/changelog.txt
+++ b/docs/changelog.txt
@@ -16,7 +16,7 @@
* `__class__` is assignable, so a mock can pass an `isinstance` check without
requiring a spec
* Addition of `PropertyMock`
-* `MagicMocks` are unorderable by default (in Python 3), the comparison methods
+* `MagicMocks` are unorderable by default (in Python 3). The comparison methods
(other than equality and inequality) return `NotImplemented`
diff --git a/docs/mock.txt b/docs/mock.txt
index 9b02d88..6182791 100644
--- a/docs/mock.txt
+++ b/docs/mock.txt
@@ -511,6 +511,15 @@
>>> isinstance(mock, int)
True
+ `__class__` is assignable to, this allows a mock to pass an
+ `isinstance` check without forcing you to use a spec:
+
+ .. doctest::
+
+ >>> mock = Mock()
+ >>> mock.__class__ = dict
+ >>> isinstance(mock, dict)
+ True
.. class:: NonCallableMock(spec=None, wraps=None, name=None, spec_set=None, **kwargs)