diff --git a/src/lib.rs b/src/lib.rs
index fa38ce1..cf239c0 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -392,6 +392,9 @@ impl Connection {
     /// If the query returns more than one row, all rows except the first are
     /// ignored.
     ///
+    /// Returns `Err(QueryReturnedNoRows)` if no results are returned. If the query truly is optional,
+    /// you can call `.optional()` on the result of this to get a `Result<Option<T>>`.
+    ///
     /// # Failure
     ///
     /// Will return `Err` if `sql` cannot be converted to a C-compatible string
@@ -412,6 +415,9 @@ impl Connection {
     /// If the query returns more than one row, all rows except the first are
     /// ignored.
     ///
+    /// Returns `Err(QueryReturnedNoRows)` if no results are returned. If the query truly is optional,
+    /// you can call `.optional()` on the result of this to get a `Result<Option<T>>`.
+    ///
     /// # Failure
     ///
     /// Will return `Err` if `sql` cannot be converted to a C-compatible string
diff --git a/src/statement.rs b/src/statement.rs
index 1bcf4ed..58d290d 100644
--- a/src/statement.rs
+++ b/src/statement.rs
@@ -377,6 +377,9 @@ impl<'conn> Statement<'conn> {
     /// If the query returns more than one row, all rows except the first are
     /// ignored.
     ///
+    /// Returns `Err(QueryReturnedNoRows)` if no results are returned. If the query truly is optional,
+    /// you can call `.optional()` on the result of this to get a `Result<Option<T>>`.
+    ///
     /// # Failure
     ///
     /// Will return `Err` if the underlying SQLite call fails.