Document to_legacy_urlsafe as being equivalent to ndb. (googleapis#3783)

lukesneeringer · landrito · commit 7324c9e1c155 · 2017-08-22T12:57:56.000-07:00
diff --git a/datastore/google/cloud/datastore/key.py b/datastore/google/cloud/datastore/key.py
@@ -307,6 +307,11 @@ def to_legacy_urlsafe(self):
         argument to ``ndb.Key(urlsafe=...)``. The base64 encoded values
         will have padding removed.
 
+        .. note::
+
+            The string returned by ``to_legacy_urlsafe`` is equivalent, but
+            not identical, to the string returned by ``ndb``.
+
         :rtype: bytes
         :returns: A bytestring containing the key encoded as URL-safe base64.
         """
