Issue #3450149 by jwilson3: Fix OOM issue with label_help_debug

Closes #3450149

README.md

@@ -31,11 +31,28 @@ This module requires no modules outside of Drupal core.
 
 ## Troubleshooting
 
-If a given field or widget type is not behaving like you would expect, you can
-enable debug mode in settings.php with the following line:
+1.  Label Help placement logic 'use case' debugging.
 
-    $settings['label_help_debug'] = TRUE;
+    If a given field or widget type is not behaving as expected, enable debug
+    mode in settings.php with the following line:
 
+        $settings['label_help_debug'] = TRUE;
+
+    Then reload the form page to see debug output identifying the field widget
+    type and use case matched by Label Help placement logic. If no use case is
+    detected you'll see a warning message.
+
+2.  Form API dump debugging
+
+    To troubleshoot Form API structures for a given form field enable the Form
+    API element dump mode in settings.php with the following line:
+
+        $settings['label_help_debug_dump'] = TRUE;
+
+    This debug mode leverages the Symfony Variable Dumper `dump()` to provide
+    a drillable screen dump of the Form API element array. However, because
+    this dump runs inside the form_alter, it can result in incomplete page
+    load. This is expected.
 
 ## Using Label Help to create form fields programmatically