From 912a8a076e47878ccc9393f58a6d424830bc3e37 Mon Sep 17 00:00:00 2001 From: Merlin Beutlberger Date: Tue, 23 Jul 2024 14:37:38 +0200 Subject: [PATCH] Formatting, details --- docs/pages/Configuration.md | 6 ++++-- docs/updates/migrate-v4.md | 8 ++++++-- 2 files changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/pages/Configuration.md b/docs/pages/Configuration.md index 360a06b8d1..76714c0b93 100644 --- a/docs/pages/Configuration.md +++ b/docs/pages/Configuration.md @@ -758,11 +758,13 @@ Version | UI5 CLI Release **Breaking changes:** -- Remove bundle option [`usePredefineCalls`](#properties). UI5 CLI v4.0.0 and above will always use predefine calls in bundles, making this option obsolete. -- New option “async“ for [builder.bundles.bundleDefinition.section](#properties) +- Removed bundle option [`usePredefineCalls`](#properties). UI5 CLI v4.0.0 and above will always use predefine calls in bundles, making this option obsolete. +- Adds new a new option `async` for `bundleDefinition`-section configuration, see [Configuration: `bundleDefinition.sections`](../pages/Configuration.md#properties) for details. Specification Version 4.0 projects are supported by [UI5 CLI](https://github.com/SAP/ui5-cli) v4.0.0 and above. +Also see [Migrate to v4](../updates/migrate-v4.md#changes-for-projects) for details on these breaking changes. + ### Specification Version 3.2 **Features:** diff --git a/docs/updates/migrate-v4.md b/docs/updates/migrate-v4.md index 277abd5d6b..f63567602b 100644 --- a/docs/updates/migrate-v4.md +++ b/docs/updates/migrate-v4.md @@ -43,9 +43,13 @@ For projects defining the latest **Specification Version 4.0 or higher**, the fo For more details, see [JavaScript Files Requiring Top Level Scope](../pages/Builder.md#javascript-files-requiring-top-level-scope). -* **Breaking Change:** Removal of the `usePredefineCalls` [bundle option](../pages/Configuration.md#properties). UI5 Tooling v4 will _always_ use `sap.ui.predefine` calls in bundles, making this option obsolete. We do not expect any negative impact on application behavior due to this change. +* **Breaking Change:** Removal of the `usePredefineCalls` [bundle option](../pages/Configuration.md#properties). UI5 Tooling v4 will _always_ use `sap.ui.predefine` calls in bundles, making this option obsolete. + + We do not expect any negative impact on application behavior due to this change. -* **Breaking Change:** New `async` option for the `bundleDefinition` section-configuration where the section mode equals `require`. This option defaults to `true` for Specification Version 4.0 and higher, which can influence the loading behavior of your project. Note that the same default is used for all standard bundles, like the component- or library preloads as well as self-contained bundles. See [Configuration: `bundleDefinition.sections`](../pages/Configuration.md#properties) for details. +* **Breaking Change:** New `async` option for the `bundleDefinition`-section configuration where the section mode equals `require`. + + This option defaults to `true` for Specification Version 4.0 and higher, which can influence the loading behavior of your project. Note that the same default is used for all standard bundles, like the component- or library preloads as well as self-contained bundles. See [Configuration: `bundleDefinition.sections`](../pages/Configuration.md#properties) for details. See also [Configuration: Specification Version 4.0](../pages/Configuration.md#specification-version-40).