--- a/selectors.py	Fri Jan 21 12:51:58 2011 +0100
+++ b/selectors.py	Thu Jan 20 14:38:53 2011 +0100
@@ -1145,6 +1145,11 @@
     must use 'X' variable to represent the context entity and may use 'U' to
     represent the request's user.
 
+    .. warning::
+        If simply testing value of some attribute/relation of context entity (X),
+        you should rather use the :class:`score_entity` selector which will
+        benefit from the ORM's request entities cache.
+
     See :class:`~cubicweb.selectors.EntitySelector` documentation for entity
     lookup / score rules according to the input context.
     """