[RHDHBUGS-521]: Fix confusing plugin enable YAML snippets (#2142)

Replace Helm-specific global.dynamic format with dynamic-plugins.yaml
plugins: format across 7 proc-enable files. Add explicit file context
("in your dynamic-plugins.yaml file") so users know which file to
modify. Migrate Keycloak and K8s custom actions from deprecated wrapper
paths to OCI references.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: themr0c

modules/shared/proc-enable-kubernetes-custom-actions-plugin-in-rhdh.adoc

@@ -4,30 +4,24 @@
 = Enable Kubernetes custom actions plugin in {product}
 
 [role="_abstract"]
-Enable the preinstalled Kubernetes custom actions plugin by updating the Helm chart configuration.
+Enable the preinstalled Kubernetes custom actions plugin by updating the dynamic plugins configuration.
 
-In {product}, the Kubernetes custom actions are provided as a preinstalled plugin, which is disabled by default. You can enable the Kubernetes custom actions plugin by updating the `disabled` key value in your Helm chart.
-
-.Prerequisites
-
-* You have installed {product} with the Helm chart.
+In {product}, the Kubernetes custom actions are provided as a preinstalled plugin, which is disabled by default. You can enable the Kubernetes custom actions plugin by updating the `disabled` key value in your `dynamic-plugins.yaml` file.
 
 .Procedure
 
-* In your Helm chart, add a `package` with the Kubernetes custom action plugin name and update the `disabled` field to enable the plugin. For example:
+* Add a `package` with the Kubernetes custom action plugin name and update the `disabled` field in your `dynamic-plugins.yaml` file to enable the plugin. For example:
 +
 --
-[source,yaml]
+[source,yaml,subs="+quotes"]
 ----
-global:
-  dynamic:
-    includes:
-      - dynamic-plugins.default.yaml
-    plugins:
-      - package: ./dynamic-plugins/dist/backstage-community-plugin-scaffolder-backend-module-kubernetes-dynamic
-        disabled: false
+plugins:
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-scaffolder-backend-module-kubernetes-dynamic:__<tag>__
+    disabled: false
 ----
 
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
+
 [NOTE]
 ====
 The default configuration for a plugin is extracted from the `dynamic-plugins.default.yaml` file, however, you can use a `pluginConfig` entry to override the default configuration.

modules/shared/proc-enable-servicenow-custom-actions-plugin-in-rhdh.adoc

@@ -13,18 +13,14 @@ To use ServiceNow custom actions, you must first activate the plugin.
 
 .Procedure
 
-. Add a `package` with plugin name and update the `disabled` field in your Helm chart as follows:
+. Add a `package` with plugin name and update the `disabled` field in your `dynamic-plugins.yaml` file as follows:
 +
 --
 [source,yaml,subs="+quotes"]
 ----
-global:
-  dynamic:
-    includes:
-      - dynamic-plugins.default.yaml
-    plugins:
-      - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-scaffolder-backend-module-servicenow:__<tag>__
-        disabled: false
+plugins:
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-scaffolder-backend-module-servicenow:__<tag>__
+    disabled: false
 ----
 
 include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
@@ -35,7 +31,7 @@ The default configuration for a plugin is extracted from the `dynamic-plugins.de
 ====
 --
 
-. Set the following variables in the Helm chart to access the custom actions:
+. Set the following variables in your `{my-app-config-file}` file to access the custom actions:
 +
 --
 [source,yaml]

modules/shared/proc-enable-the-argo-cd-plugin.adoc

@@ -62,10 +62,17 @@ If you do not set this annotation, the Argo CD plugin defaults to the first Argo
 
 .Procedure
 
-* Add the following to your dynamic-plugins ConfigMap to enable the Argo CD plugin.
+* To enable the Argo CD plugin, set the `disabled` property to `false` in your `dynamic-plugins.yaml` file as follows:
 +
 [source,yaml,subs="+quotes"]
 ----
+<<<<<<< RHDHBUGS-521-plugin-enable-snippets
+plugins:
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/roadiehq-backstage-plugin-argo-cd-backend:__<tag>__
+    disabled: false
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-argocd:__<tag>__
+    disabled: false
+=======
 global:
   dynamic:
     includes:
@@ -75,6 +82,7 @@ global:
         disabled: false
       - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-argocd:__<tag>__
         disabled: false
+>>>>>>> main
 ----
 
 include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]

modules/shared/proc-enable-the-jfrog-artifactory-plugin.adoc

@@ -7,17 +7,13 @@
 To enable the JFrog Artifactory plugin, set the `disabled` property to `false`.
 
 .Procedure
-* Set the value to `false` as follows:
+* To enable the JFrog Artifactory plugin, set the `disabled` property to `false` in your `dynamic-plugins.yaml` file as follows:
 +
 [source,yaml,subs="+quotes"]
 ----
-global:
-  dynamic:
-    includes:
-      - dynamic-plugins.default.yaml
-    plugins:
-      - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-jfrog-artifactory:__<tag>__
-        disabled: false
+plugins:
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-jfrog-artifactory:__<tag>__
+    disabled: false
 ----
 +
 include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]

modules/shared/proc-enable-the-keycloak-plugin.adoc

@@ -20,15 +20,15 @@ Enable the Keycloak plugin to synchronize users and groups from your {rhbk-brand
 ** `KEYCLOAK_CLIENT_SECRET`
 
 .Procedure
-* The Keycloak plugin is pre-loaded in {product-short} with basic configuration properties. To enable it, set the `disabled` property to `false` as follows:
+* The Keycloak plugin is pre-loaded in {product-short} with basic configuration properties. To enable it, set the `disabled` property to `false` in your `dynamic-plugins.yaml` file as follows:
 +
-[source,yaml]
+--
+[source,yaml,subs="+quotes"]
 ----
-global:
-  dynamic:
-    includes:
-      - dynamic-plugins.default.yaml
-    plugins:
-      - package: ./dynamic-plugins/dist/backstage-community-plugin-catalog-backend-module-keycloak-dynamic
-        disabled: false
+plugins:
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-catalog-backend-module-keycloak-dynamic:__<tag>__
+    disabled: false
 ----
+
+include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]
+--

modules/shared/proc-enable-the-nexus-repository-manager-plugin.adoc

@@ -7,17 +7,13 @@
 To enable the Nexus Repository Manager plugin, set the `disabled` property to `false`.
 
 .Procedure
-* Set the value to `false` as follows:
+* To enable the Nexus Repository Manager plugin, set the `disabled` property to `false` in your `dynamic-plugins.yaml` file as follows:
 +
 [source,yaml,subs="+quotes"]
 ----
-global:
-  dynamic:
-    includes:
-      - dynamic-plugins.default.yaml
-    plugins:
-      - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-nexus-repository-manager:__<tag>__
-        disabled: false
+plugins:
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-nexus-repository-manager:__<tag>__
+    disabled: false
 ----
 +
 include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]

modules/shared/proc-enable-the-tekton-plugin.adoc

@@ -127,18 +127,12 @@ labels:
 When you use the label selector, the mentioned labels must be present on the resource.
 
 .Procedure
-* To enable the Tekton plugin, set the `disabled` property to `false` as follows:
+* To enable the Tekton plugin, set the `disabled` property to `false` in your `dynamic-plugins.yaml` file as follows:
 +
---
 [source,yaml,subs="+quotes"]
 ----
-global:
-  dynamic:
-    includes:
-      - dynamic-plugins.default.yaml
-    plugins:
-      - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-tekton:__<tag>__
-        disabled: false
+plugins:
+  - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/backstage-community-plugin-tekton:__<tag>__
+    disabled: false
 ----
---
 include::{docdir}/artifacts/snip-tag-for-OCI-package-paths.adoc[]