diff --git a/src/Transaction.jl b/src/Transaction.jl
index 4f273b3e531692000297891f33b7c1344771cad5..59e94786a669fd193f7f1b6c1710255621bfdc07 100644
--- a/src/Transaction.jl
+++ b/src/Transaction.jl
@@ -181,7 +181,7 @@ Add a query sub-request to the given `transaction`.
 
 !!! info
 
-    This dows not execute the transaction
+    This does not execute the transaction
 """
 function add_query(transaction::Ref{_Transaction}, query::AbstractString)
 
@@ -366,6 +366,14 @@ end
 Execute the given `query` and return its results. Use the connection
 with the given `name`. If none is given, the default connection is
 used.
+
+!!! info
+
+    Since only the resulting entities are returned, this only makes
+    sense for FIND (and, in the future, SELECT) queries. To get the
+    result of a `COUNT` query, you have to execute the transaction
+    yourself using `create_transaction`, `add_query`, and `execute`,
+    and get the result with `get_count_result`.
 """
 function execute_query(query::AbstractString, name::AbstractString = "default")
 
@@ -386,6 +394,14 @@ end
 
 Execute the given `query` and return its results. Use the given
 `connection`.
+
+!!! info
+
+    Since only the resulting entities are returned, this only makes
+    sense for FIND (and, in the future, SELECT) queries. To get the
+    result of a `COUNT` query, you have to execute the transaction
+    yourself using `create_transaction`, `add_query`, and `execute`,
+    and get the result with `get_count_result`.
 """
 function execute_query(
     query::AbstractString,