Merge remote-tracking branch 'origin/pr/205'

1 files changed, 12 insertions, 0 deletions

diff --git a/lib/sqlalchemy/orm/query.py b/lib/sqlalchemy/orm/query.py
index 0af22b229..43cb198ea 100644
--- a/lib/sqlalchemy/orm/query.py
+++ b/lib/sqlalchemy/orm/query.py
@@ -2464,6 +2464,12 @@ class Query(object):
 
         Calling ``first()`` results in an execution of the underlying query.
 
+        .. seealso::
+
+            :meth:`.Query.one`
+
+            :meth:`.Query.one_or_none`
+
         """
         if self._statement is not None:
             ret = list(self)[0:1]
@@ -2496,6 +2502,12 @@ class Query(object):
 
             Added :meth:`.Query.one_or_none`
 
+        .. seealso::
+
+            :meth:`.Query.first`
+
+            :meth:`.Query.one`
+
         """
         ret = list(self)