diff --git a/mappings/net/minecraft/client/gui/screen/ButtonTextures.mapping b/mappings/net/minecraft/client/gui/screen/ButtonTextures.mapping
index b25b9c407a..fa0093fcba 100644
--- a/mappings/net/minecraft/client/gui/screen/ButtonTextures.mapping
+++ b/mappings/net/minecraft/client/gui/screen/ButtonTextures.mapping
@@ -1,11 +1,34 @@
 CLASS net/minecraft/class_8666 net/minecraft/client/gui/screen/ButtonTextures
+	COMMENT A set of button textures. It contains four texture choices, one of each of the cases
+	COMMENT where a button is enabled/disabled and focused/not focused.
+	FIELD comp_1604 Lnet/minecraft/class_2960;
+		COMMENT the texture for when the widget is enabled, but not focused
+	FIELD comp_1605 Lnet/minecraft/class_2960;
+		COMMENT the texture for when the widget is disabled, but not focused
+	FIELD comp_1606 Lnet/minecraft/class_2960;
+		COMMENT the texture for when the widget is enabled and focused
+	FIELD comp_1607 Lnet/minecraft/class_2960;
+		COMMENT the texture for when the widget is disabled and focused
 	METHOD <init> (Lnet/minecraft/class_2960;Lnet/minecraft/class_2960;)V
+		COMMENT Constructs a set of button textures where only focusing the widget affects
+		COMMENT the textures.
 		ARG 1 unfocused
+			COMMENT the texture for when the widget is not focused
 		ARG 2 focused
+			COMMENT the texture for when the widget is focused
 	METHOD <init> (Lnet/minecraft/class_2960;Lnet/minecraft/class_2960;Lnet/minecraft/class_2960;)V
+		COMMENT Constructs a set of button textures where both disabled cases use the same texture.
 		ARG 1 enabled
-		ARG 2 focused
-		ARG 3 disabled
+			COMMENT the texture for when the widget is enabled, but not focused
+		ARG 2 disabled
+			COMMENT the texture for when the widget is disabled
+		ARG 3 focused
+			COMMENT the texture for when the widget is enabled and focused
 	METHOD method_52729 get (ZZ)Lnet/minecraft/class_2960;
+		COMMENT Gets a specific texture option from this texture set.
+		COMMENT
+		COMMENT @return the texture identifier matching the widget state
 		ARG 1 enabled
+			COMMENT {@code true} if the widget is enabled, {@code false} otherwise
 		ARG 2 focused
+			COMMENT {@code true} if the widget is focused, {@code false} otherwise
diff --git a/mappings/net/minecraft/util/math/Box.mapping b/mappings/net/minecraft/util/math/Box.mapping
index 170ccde8b4..e2d086df9b 100644
--- a/mappings/net/minecraft/util/math/Box.mapping
+++ b/mappings/net/minecraft/util/math/Box.mapping
@@ -90,9 +90,12 @@ CLASS net/minecraft/class_238 net/minecraft/util/math/Box
 	METHOD method_1014 expand (D)Lnet/minecraft/class_238;
 		COMMENT @see #contract(double)
 		ARG 1 value
-	METHOD method_17939 getXLength ()D
-	METHOD method_17940 getYLength ()D
-	METHOD method_17941 getZLength ()D
+	METHOD method_17939 getLengthX ()D
+		COMMENT {@return the length of this box on the X axis}
+	METHOD method_17940 getLengthY ()D
+		COMMENT {@return the length of this box on the Y axis}
+	METHOD method_17941 getLengthZ ()D
+		COMMENT {@return the length of this box on the Z axis}
 	METHOD method_18804 stretch (Lnet/minecraft/class_243;)Lnet/minecraft/class_238;
 		ARG 1 scale
 	METHOD method_19316 from (Lnet/minecraft/class_3341;)Lnet/minecraft/class_238;