diff --git a/src/Data/Result.php b/src/Data/Result.php
index b9a60e03a04b..21a487d59f0b 100644
--- a/src/Data/Result.php
+++ b/src/Data/Result.php
@@ -61,7 +61,7 @@ public function map(callable $f);
 	/**
 	 * Get a new result from the callable or do nothing if this is an error.
 	 *
-	 * If null is returned the result is not touched.
+	 * If null is returned from $f, the result is not touched.
 	 *
 	 * Does nothing if !isOK. This is monadic bind.
 	 *
@@ -74,7 +74,7 @@ public function then(callable $f);
 	 * Feed the error into a callable and replace this with the result
 	 * or do nothing if this is a value.
 	 *
-	 * If null is returned, the error in the result is not touched.
+	 * If null is returned from $f, the error in the result is not touched.
 	 *
 	 * Does nothing if !isError.
 	 *