From 27260699e36c0da6c4eebdd140738b5024b9fd00 Mon Sep 17 00:00:00 2001 From: Yavor Ivanov Date: Tue, 26 Sep 2023 10:26:29 +0300 Subject: [PATCH] Improve docs for subscription to disabled tasks --- docs/pages/extensibility/CustomTasks.md | 3 ++- docs/updates/migrate-v3.md | 2 +- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/pages/extensibility/CustomTasks.md b/docs/pages/extensibility/CustomTasks.md index 7456628cf7..37828a0a52 100644 --- a/docs/pages/extensibility/CustomTasks.md +++ b/docs/pages/extensibility/CustomTasks.md @@ -10,7 +10,8 @@ Please note that custom tasks from third parties can not only modify your projec You can configure your build process with additional build task. These custom tasks are defined in the project [configuration](../Configuration.md). -To hook your custom tasks into the different build phases of a project, they need to reference other tasks to be executed before or after. This can be a [standard task](../Builder.md#standard-tasks) or another custom task. Disabled standard tasks, although not executed, can still be referenced by custom tasks that will be carried out on the correct position. +To hook your custom tasks into the different build phases of a project, they need to reference other tasks to be executed before or after. This can be a [standard task](../Builder.md#standard-tasks) or another custom task. +Standard tasks that are disabled, even though they are not executed, can still be referenced by custom tasks, which will be performed in their designated position. In the below example, when building the library `my.library` the custom `babel` task will be executed before the standard task `generateComponentPreload`. Another custom task called `render-markdown-files` is then executed immediately after the standard task `minify`. diff --git a/docs/updates/migrate-v3.md b/docs/updates/migrate-v3.md index 64900add43..db99d258a1 100644 --- a/docs/updates/migrate-v3.md +++ b/docs/updates/migrate-v3.md @@ -171,7 +171,7 @@ The following processors have been removed: | UI5 Tooling v2 | UI5 Tooling v3 | Note | | --------------------------- | --------------------------- | ------------------------- | -| createDebugFiles
uglify | minify | The minify task is executed earlier, before the bundling process takes place. Any existing 'beforeTask' or 'afterTask' configuration of custom tasks might need to be adapted to cater for this change. | +| createDebugFiles
uglify | minify | The minify task is executed earlier, before the bundling process takes place. Any existing `beforeTask` or `afterTask` configuration of custom tasks might need to be adapted to cater for this change.
To adapt, you can use the `generateResourcesJson` for subscription before or after the last standard task. By default, `generateResourcesJson` is disabled, but you can still subscribe to it, ensuring your custom task executes in the correct order. | | generateVersionInfo | generateVersionInfo | The task is no longer executed by default for application projects. It can be re-enabled by using the `--include-task` parameter. | | generateManifestBundle | *None* | This task was only needed for the HTML5 repository in Cloud Foundry. Meanwhile, the HTML5 repository implemented its own mechanism, so the task is no longer needed |