Add documentation for scriptStart/scriptEnd

Refs #18878

Author: markstory

en/appendices/5-3-migration-guide.rst

@@ -127,13 +127,6 @@ Routing
   enum backed properties as route parameters. When an enum backed property is
   used in routing, the enum's ``value`` or ``name`` will be used.
 
-Validation
-----------
-
-- ``ipOrRange()`` validation has has been added to check for an IP or a range (subnet).
-- When validating within CakePHP marshalling context, the entity will be passed into the ``context`` argument for use inside custom validation rules.
-  This can be useful when patching partially and then needing to get that data from the entity instead of the passed data.
-
 TestSuite
 ---------
 
@@ -146,3 +139,18 @@ Utility
 - ``Text::uuid()`` now supports configurable UUID generation. You can set a custom
   UUID generator using ``Configure::write('Text.uuidGenerator', $closure)`` to
   integrate your own UUID generation strategy or third-party libraries.
+
+Validation
+----------
+
+- ``ipOrRange()`` validation has has been added to check for an IP or a range (subnet).
+- When validating within CakePHP marshalling context, the entity will be passed into the ``context`` argument for use inside custom validation rules.
+  This can be useful when patching partially and then needing to get that data from the entity instead of the passed data.
+
+View
+----
+
+- :php:meth:`HtmlHelper::scriptStart()` and ``scriptEnd()`` now allow simple
+  wrapping script tags (``<script>...</script>``) around inline JavaScript. This
+  enables syntax highlighting in many editors to work. The wrapping script tag
+  will be removed and replaced with a script tag generated by the helper.

en/views/helpers/html.rst

@@ -555,12 +555,30 @@ or buffered into a block::
     echo "alert('I am in the JavaScript');";
     $this->Html->scriptEnd();
 
+You can use simple ``<script>...</script>`` tags inside the script block to
+enable syntax highlighting and LSP support in many editors::
+
+    <?php $this->Html->scriptStart(['block' => true]) ?>
+    <script>
+        document.addEventListener('DOMContentLoaded', function() {
+            alert('I am in the JavaScript');
+        });
+    </script>
+    <?php $this->Html->scriptEnd() ?>
+
+The wrapping ``script``tag will be removed and replaced with a script tag
+generated by the helper that includes a CSP nonce if available.
+
 Once you have buffered javascript, you can output it as you would any other
 :ref:`View Block <view-blocks>`::
 
     // In your layout
     echo $this->fetch('script');
 
+.. versionchanged:: 5.3.0
+   Support for ``script`` tags inside ``scriptStart()``/``scriptEnd()`` was
+   added.
+
 Creating Javascript Importmap
 -----------------------------