micropython
diff --git a/‎docs/esp32/quickref.rst
Lines changed: 28 additions & 0 deletions b/‎docs/esp32/quickref.rst
Lines changed: 28 additions & 0 deletions
diff --git a/‎docs/library/machine.WDT.rst
Lines changed: 6 additions & 30 deletions b/‎docs/library/machine.WDT.rst
Lines changed: 6 additions & 30 deletions
@@ -425,6 +425,34 @@ See :ref:`machine.WDT <machine.WDT>`. ::
     wdt = WDT(timeout=5000)  # timeout in milliseconds
     wdt.feed()
 
+
+When the WDT timeout is short, there is a software update issue:
+you don't have enough time to copy the updates to the device.
+ESP32 alows reinitialise the watchdog with a longer timeout – like an hour.
+
+More comprehansive example usage::
+
+    # main.py  # starts automatically after boot.py
+    import sys
+    from machine import WDT
+
+    wdt = WDT(timeout=5000)  # 5s
+
+    while True:  # infinite work loop
+        # do something useful in less than 5 seconds
+
+        # 1/0  # uncoment this line to raise an runtime exception, then WDT reboot
+
+        # while True:  # uncomment three lines to simulate program deadlock, then WDT reboot
+        #     print('Wait for WDT reboot')
+        #     sleep_ms(1000)
+
+        wdt.feed()  # all right
+
+        if False:  # replace False with True to terminate the program
+            wdt = WDT(timeout=1000 * 60 * 60)  # 1 hour before WDT reboot
+            sys.exit(0)  # will enter to REPL(WebREPL)
+
 Deep-sleep mode
 ---------------
 
 
@@ -5,43 +5,19 @@ class WDT -- watchdog timer
 ===========================
 
 The WDT is used to restart the system when the application crashes and ends
-up into a non recoverable state. Once started it cannot be stopped
-in any way. After enabling, the application must "feed" the
+up into a non recoverable state. Once started it cannot be stopped or
+reconfigured in any way. After enabling, the application must "feed" the
 watchdog periodically to prevent it from expiring and resetting the system.
 
 Example usage::
 
     from machine import WDT
     wdt = WDT(timeout=2000)  # enable it with a timeout of 2s
-    wdt.feed()
+    while True:
+        # do something useful in less than 2 seconds
 
-
-When the WDT timeout is short, there is a software update issue:
-you don't have enough time to copy the updates to the device.
-You may reinitialise the watchdog with a longer timeout – like an hour.
-
-More comprehansive example usage::
-
-    # main.py  # starts automatically after boot.py
-    import sys
-    from machine import WDT
-
-    wdt = WDT(timeout=5000)  # 5s
-
-    while True:  # infinite work loop
-        # do something useful in less than 5 seconds
-
-        # 1/0  # uncoment this line to raise an runtime exception, then WDT reboot
-
-        # while True:  # uncomment three lines to simulate program deadlock, then WDT reboot
-        #     print('Wait for WDT reboot')
-        #     sleep_ms(1000)
-
-        wdt.feed()  # all right
-
-        if False:  # replace False with True to terminate the program
-            wdt = WDT(timeout=1000 * 60 * 60)  # 1 hour before WDT reboot
-            sys.exit(0)  # will enter to REPL(WebREPL)
+        if verify_that_everything_is_functioning_correctly():
+            wdt.feed()
 
 Availability of this class: pyboard, WiPy, esp8266, esp32.