docs: Complete migration steps

d3xter666 · d3xter666 · commit 4d2be1d5ef16 · 2025-11-28T15:36:45.000+02:00
diff --git a/internal/documentation/docs/updates/migrate-v5.md b/internal/documentation/docs/updates/migrate-v5.md
@@ -43,7 +43,7 @@ This feature will allow developers to serve and build multiple UI5 application c
 
 If you have an existing application that you'd like to migrate to the Component Type, follow these steps:
 
-#### 1. Update ui5.yaml Configuration
+#### 1. Update `ui5.yaml` Configuration
 
 Update your `ui5.yaml` file to use the Component Type and Specification Version 5.0:
 
@@ -102,6 +102,87 @@ my-app/
 ```
 :::
 
+#### 3. Adjust `index.html`
+
+The `index.html` file is typically moved from `/webapp` to `/test` since it's primarily used for testing the component.
+
+Update the bootstrap script path and remove the obsolete `data-sap-ui-resourceroots` configuration:
+
+::: code-group
+```html [Before (webapp/index.html)]
+<script
+    id="sap-ui-bootstrap"
+    src="resources/sap-ui-core.js"
+    data-sap-ui-libs="sap.m"
+    data-sap-ui-theme="sap_horizon"
+    data-sap-ui-resourceroots='{
+        "sap.ui.demo.todo": "./"
+    }'
+    data-sap-ui-on-init="module:sap/ui/core/ComponentSupport"
+    data-sap-ui-async="true">
+</script>
+```
+
+```html [After (test/index.html)]
+<script
+    id="sap-ui-bootstrap"
+    src="../../../../../resources/sap-ui-core.js"
+    data-sap-ui-libs="sap.m"
+    data-sap-ui-theme="sap_horizon"
+    data-sap-ui-on-init="module:sap/ui/core/ComponentSupport"
+    data-sap-ui-async="true">
+</script>
+```
+:::
+
+
+#### 4. Adjust `testsuite.qunit.html`
+
+Simplify the test suite HTML by removing obsolete bootstrap attributes:
+
+::: code-group
+```html [Before (webapp/test/testsuite.qunit.html)]
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="utf-8">
+    <title>QUnit test suite for Todo App</title>
+    <script
+        src="../resources/sap/ui/test/starter/createSuite.js"
+        data-sap-ui-testsuite="test-resources/sap/ui/demo/todo/testsuite.qunit"
+        data-sap-ui-resourceroots='{
+            "test-resources.sap.ui.demo.todo": "./"
+        }'
+    ></script>
+</head>
+<body>
+</body>
+</html>
+```
+
+```html [After (test/testsuite.qunit.html)]
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="utf-8">
+    <title>QUnit test suite for Todo App</title>
+    <script src="../../../../../resources/sap/ui/test/starter/createSuite.js"></script>
+</head>
+<body>
+</body>
+</html>
+```
+:::
+
+**Changes:**
+- Remove the `data-sap-ui-testsuite` attribute
+- Remove the `data-sap-ui-resourceroots` attribute
+- Update the `src` path to the correct relative location
+
+#### 5. Delete Obsolete Test Files
+
+Delete the custom `Test.qunit.html` file from your test directory. This file is no longer needed. The framework-provided test page can now be used directly. 
+
 
 ## Learn More
 
