diff --git a/stubs/micropython-v1_24_0_preview-docstubs/machine.pyi b/stubs/micropython-v1_24_0_preview-docstubs/machine.pyi
index ad666204e..b9df9bc8d 100644
--- a/stubs/micropython-v1_24_0_preview-docstubs/machine.pyi
+++ b/stubs/micropython-v1_24_0_preview-docstubs/machine.pyi
@@ -1626,16 +1626,22 @@ def freq(hz: Optional[Any] = None) -> Incomplete:
 
 def idle() -> Incomplete:
     """
-    Gates the clock to the CPU, useful to reduce power consumption at any time during
-    short or long periods. Peripherals continue working and execution resumes as soon
-    as any interrupt is triggered (on many ports this includes system timer
-    interrupt occurring at regular intervals on the order of millisecond).
+    Gates the clock to the CPU, useful to reduce power consumption at any time
+    during short or long periods. Peripherals continue working and execution
+    resumes as soon as any interrupt is triggered, or at most one millisecond
+    after the CPU was paused.
+
+    It is recommended to call this function inside any tight loop that is
+    continuously checking for an external change (i.e. polling). This will reduce
+    power consumption without significantly impacting performance. To reduce
+    power consumption further then see the :func:`lightsleep`,
+    :func:`time.sleep()` and :func:`time.sleep_ms()` functions.
     """
     ...
 
 def sleep() -> Incomplete:
     """
-    ``Note:`` This function is deprecated, use `lightsleep()` instead with no arguments.
+    ``Note:`` This function is deprecated, use :func:`lightsleep()` instead with no arguments.
     """
     ...
 
diff --git a/stubs/micropython-v1_24_0_preview-docstubs/modules.json b/stubs/micropython-v1_24_0_preview-docstubs/modules.json
index 9596fa1d1..62b8d2764 100644
--- a/stubs/micropython-v1_24_0_preview-docstubs/modules.json
+++ b/stubs/micropython-v1_24_0_preview-docstubs/modules.json
@@ -8,7 +8,7 @@
         "firmware": "micropython-v1_24_0_preview",
         "nodename": "micropython",
         "version": "v1.24.0-preview",
-        "release": "v1.24.0-preview-121-g444d7bacb",
+        "release": "v1.24.0-preview-132-gba9853345",
         "sysname": "micropython"
     },
     "stubber": {