[WIP] Document breaking changes

colinrotherham · colinrotherham · commit e771bc280394 · 2025-09-08T17:47:15.000+01:00
diff --git a/docs/upgrade-to-6.0.md b/docs/upgrade-to-6.0.md
@@ -0,0 +1,17 @@
+# Upgrading to 6.0
+
+There are some breaking changes you'll need to be aware of when upgrading to v6. These are mostly related to us upgrading our dependency on [nhsuk-frontend to v10](https://github.com/nhsuk/nhsuk-frontend/releases/tag/v10.0.0) which also includes breaking changes.
+
+## Breaking changes
+
+### Update the JavaScript supported script snippet
+
+For NHS.UK React components v4.x we recommended `<body class="js-enabled">` to enable styling for JavaScript only features.
+
+You must now use the NHS.UK frontend v10.x feature detection snippet to detect `<script type="module">` support:
+
+```patch
+- <body class="js-enabled">
++ <body>
++   <script>document.body.className += ' js-enabled' + ('noModule' in HTMLScriptElement.prototype ? ' nhsuk-frontend-supported' : '');</script>
+```
