diff --git a/firmware/controllers/actuators/idle_state.txt b/firmware/controllers/actuators/idle_state.txt
index 42fc3625d8..f53e2a5900 100644
--- a/firmware/controllers/actuators/idle_state.txt
+++ b/firmware/controllers/actuators/idle_state.txt
@@ -7,19 +7,19 @@ custom idle_state_e 4 bits, S32, @OFFSET@, [0:2], "not important"
 
     percent_t currentIdlePosition;"idle: current position\nthat's current position with CLT and IAT corrections"
     percent_t baseIdlePosition;"idle: base value\ncurrent position without adjustments (iacByTpsTaper, afterCrankingIACtaperDuration)"
-    percent_t iacByTpsTaper;iacByTpsTaper portion of idle
+    percent_t iacByTpsTaper;idle: iacByTpsTaper portion of idle
     int throttlePedalUpState;true in IDLE throttle pedal state, false if driver is touching the pedal\ntodo: better name for this field?
 
 bit mightResetPid;The idea of 'mightResetPid' is to reset PID only once - each time when TPS > idlePidDeactivationTpsThreshold.\nThe throttle pedal can be pressed for a long time, making the PID data obsolete (thus the reset is required).\nWe set 'mightResetPid' to true only if PID was actually used (i.e. idlePid.getOutput() was called) to save some CPU resources.\nSee automaticIdleController().
 
-bit shouldResetPid;
-bit wasResetPid;This is needed to slowly turn on the PID back after it was reset.
-bit mustResetPid;This is used when the PID configuration is changed, to guarantee the reset
-bit isCoasting
+bit shouldResetPid;idle: shouldResetPid
+bit wasResetPid;idle: wasResetPid\nThis is needed to slowly turn on the PID back after it was reset.
+bit mustResetPid;idle: mustResetPid\nThis is used when the PID configuration is changed, to guarantee the reset
+bit isCoasting;idle: coasting
 bit useIacTableForCoasting
 bit notIdling
-bit needReset
-bit isInDeadZone
+bit needReset;idle: reset
+bit isInDeadZone;idle: dead zone
 bit isBlipping
 bit useClosedLoop
 bit badTps
@@ -30,8 +30,8 @@ bit useInstantRpmForIdle
 bit isVerboseIAC
 
 
-int targetRpmByClt
-int targetRpmAcBump
+int targetRpmByClt;idle: target by CLT
+int targetRpmAcBump;idle: A/C bump
 
 ! end of idle_state_s structure definition
 end_struct