diff --git a/common/lib/keystore/__init__.py b/common/lib/keystore/__init__.py
index 2605424517..801ba57f80 100644
--- a/common/lib/keystore/__init__.py
+++ b/common/lib/keystore/__init__.py
@@ -43,6 +43,8 @@ class Location(object):
             }
             Location: another Location object
 
+        In both the dict and list forms, the revision is optional, and can be ommitted.
+
         None of the components of a location may contain the '/' character
 
         Components may be set to None, which may be interpreted by some contexts to mean