diff --git a/mappings/net/minecraft/util/thread/MessageListener.mapping b/mappings/net/minecraft/util/thread/MessageListener.mapping
index 3b39ad06d0..ae228b6860 100644
--- a/mappings/net/minecraft/util/thread/MessageListener.mapping
+++ b/mappings/net/minecraft/util/thread/MessageListener.mapping
@@ -6,6 +6,18 @@ CLASS net/minecraft/class_3906 net/minecraft/util/thread/MessageListener
 		ARG 0 name
 		ARG 1 action
 	METHOD method_17345 ask (Ljava/util/function/Function;)Ljava/util/concurrent/CompletableFuture;
+		COMMENT Ask a message provider for a message.
+		COMMENT
+		COMMENT The {@link CompletableFuture} returned from this function will never complete exceptionally.
+		COMMENT
+		COMMENT @return CompletableFuture future that completes with the received message
 		ARG 1 messageProvider
 	METHOD method_27918 askFallible (Ljava/util/function/Function;)Ljava/util/concurrent/CompletableFuture;
+		COMMENT Ask a falliable message provider for a message.
+		COMMENT
+		COMMENT The provider is given a MessageListener that accepts a {@link Either} representing either
+		COMMENT a valid response (generic parameter Source) or an Exception, which decides whether the
+		COMMENT future completes successfully or exceptionally.
+		COMMENT
+		COMMENT @return CompletableFuture that may either complete successfully or exceptionally
 		ARG 1 messageProvider