1 files changed, 3 insertions, 1 deletions
diff --git a/README.rst b/README.rst
index 40959c4..1cb21e5 100644
--- a/README.rst
+++ b/README.rst
@@ -181,8 +181,10 @@ Simpler test syntax is also available using the ``in`` keyword:
 .. code-block:: pycon
 
     >>> s = SimpleSpec('==0.1.1')
-    >>> Version('0.1.1-alpha1') in s
+    >>> Version('0.1.1+git7ccc72') in s  # build variants are equivalent to full versions
     True
+    >>> Version('0.1.1-alpha1') in s     # pre-release variants don't match the full version.
+    False
     >>> Version('0.1.2') in s
     False