diff --git a/mappings/net/minecraft/util/math/MathHelper.mapping b/mappings/net/minecraft/util/math/MathHelper.mapping
index ce648c2409..798d4e4afb 100644
--- a/mappings/net/minecraft/util/math/MathHelper.mapping
+++ b/mappings/net/minecraft/util/math/MathHelper.mapping
@@ -86,9 +86,28 @@ CLASS net/minecraft/class_3532 net/minecraft/util/math/MathHelper
 	METHOD method_15357 floor (D)I
 		ARG 0 value
 	METHOD method_15360 binarySearch (IILjava/util/function/IntPredicate;)I
-		ARG 0 start
-		ARG 1 end
-		ARG 2 leftPredicate
+		COMMENT Finds the minimum value in {@code [min, max)} that satisfies the
+		COMMENT monotonic {@code predicate}.
+		COMMENT
+		COMMENT <p>The {@code predicate} must be monotonic, i.e. if for any {@code a},
+		COMMENT {@code predicate.test(a)} is {@code true}, then for all {@code b > a},
+		COMMENT {@code predicate.test(b)} must also be {@code true}.
+		COMMENT
+		COMMENT <p>Examples:
+		COMMENT <ul>
+		COMMENT   <li>{@code binarySearch(3, 7, x -> true)} returns {@code 3}.
+		COMMENT   <li>{@code binarySearch(3, 7, x -> x >= 5)} returns {@code 5}.
+		COMMENT   <li>{@code binarySearch(3, 7, x -> false)} returns {@code 7}.
+		COMMENT </ul>
+		COMMENT
+		COMMENT @return the minimum value if such value is found, otherwise {@code max}
+		ARG 0 min
+			COMMENT the minimum value (inclusive) to be tested
+		ARG 1 max
+			COMMENT the maximum value (exclusive) to be tested
+		ARG 2 predicate
+			COMMENT the predicate that returns {@code true} for integers greater than or
+			COMMENT equal to the value to be searched for
 	METHOD method_15362 cos (F)F
 		ARG 0 value
 	METHOD method_15363 clamp (FFF)F