diff --git a/y2024/control_loops/superstructure/superstructure_output.fbs b/y2024/control_loops/superstructure/superstructure_output.fbs
index db756b4..b0ae6de 100644
--- a/y2024/control_loops/superstructure/superstructure_output.fbs
+++ b/y2024/control_loops/superstructure/superstructure_output.fbs
@@ -5,15 +5,20 @@
     intake_roller_voltage:double (id: 0);
 
     // Voltage of intake pivot
+    // Positive voltage causes pivot to retract.
     intake_pivot_voltage:double (id: 1);
 
     // Voltage of the turret
+    // Positive voltage is for rotating the turret clockwise.
     turret_voltage: double (id: 2);
 
     // Voltage of the altitude
+    // Positive voltage is for raising it upward.
     altitude_voltage: double (id: 3);
 
     // Voltage of the catapult
+    // Positive voltage is for shooting the game piece,
+    // rotating the catapult counter-clockwise.
     catapult_voltage: double (id: 4);
 
     // Voltage of transfer rollers
diff --git a/y2024/control_loops/superstructure/superstructure_position.fbs b/y2024/control_loops/superstructure/superstructure_position.fbs
index 7ab49a3..d6ca193 100644
--- a/y2024/control_loops/superstructure/superstructure_position.fbs
+++ b/y2024/control_loops/superstructure/superstructure_position.fbs
@@ -5,15 +5,20 @@
 
 table Position {
     // Values of the encoder and potentiometer at the intake pivot
+    // Zero is extended outwards and level, positive is retracted inward.
     intake_pivot:frc971.AbsolutePosition (id: 0);
 
     // Values of the encoder and potentiometer at the turret
+    // Zero is facing forward, positive is rotated right.
     turret:frc971.PotAndAbsolutePosition (id: 1);
 
     // Values of the encoder and potentiometer at the altitude
+    // Zero is level with the ground, positive is raised upward.
     altitude:frc971.PotAndAbsolutePosition (id: 2);
 
     // Values of the encoder and potentiometer at the catapult
+    // Zero is edge of pivot plate parallel to edge of gusset.
+    // Positive is rotated counter-clockwise, to launch game piece.
     catapult:frc971.PotAndAbsolutePosition (id: 3);
 
     // True means there is a game piece in the transfer.