Merge pull request #86270 from mramendi/RHDEVDOCS-6324

RHDEVDOCS 6324 Add the need to change pipelines with ClusterTasks to Pipelines 1.17 RNs

Author: lahinson

modules/op-release-notes-1-17.adoc

@@ -28,7 +28,7 @@ spec:
 # ...
   pipeline:
     git-resolver-config:
-      # configuration 1 
+      # configuration 1
       fetch-timeout: "1m"
       default-url: "https://github.com/tektoncd/catalog.git"
       default-revision: "main"
@@ -128,7 +128,7 @@ spec:
 # ...
   chain:
     disabled: false
-    generateSigningSecret: true 
+    generateSigningSecret: true
 # ...
 ----
 
@@ -158,7 +158,14 @@ spec:
 [id="breaking-changes-1-17_{context}"]
 == Breaking changes
 
-* With this update, the deprecated `ClusterTask` resource is removed from the Operator. As an alternative, you can use the cluster resolver.
+* With this update, the deprecated `ClusterTask` resource is removed from the Operator. As an alternative, you can use the cluster resolver to access tasks that {pipelines-shortname} installs in the `openshift-pipelines` namespace.
++
+[IMPORTANT]
+====
+Before upgrading to {pipelines-shortname} 1.17, if you configured any pipelines that use `ClusterTask` resources, you must edit them to use the tasks in the `openshift-pipelines` namespace. Otherwise, after the upgrade, the pipelines will fail.
+
+For more information about using the tasks in the `openshift-pipelines` namespace, see xref:../create/remote-pipelines-tasks-resolvers.adoc#resolver-cluster-tasks-ref_remote-pipelines-tasks-resolvers[Tasks provided in the OpenShift Pipelines namespace].
+====
 
 * With this update, the community cluster tasks are removed from the Operator. As an alternative, you can download them from the link:https://github.com/tektoncd/catalog[Tekton catalog] (GitHub resource). The community cluster tasks are planned to be added as tasks in a future release. The following list shows the removed community cluster tasks: