Apply new suggestions

Author: GitHub Actions

artifacts/attributes.adoc

@@ -29,6 +29,7 @@
 :ocp-version: 4.19
 :osd-version: 4
 :rhoserverless-version: 1.36
+:orchestrator-plugin-version: 1.8.2
 
 // Product recurrent configuration items (in alphabetical order)
 :my-app-config-config-map: my-rhdh-app-config

modules/orchestrator/con-getting-started.adoc

@@ -5,7 +5,7 @@
 
 To start using Orchestrator in {product-very-short}, you must:
 
-* Install the required infrastructure components, such as Red Hat OpenShift Serverless Operator, Knative Serving, Knative Eventing, and OpenShift Serverless Logic Operator
+* Install the required infrastructure components, such as OpenShift Serverless Operator, and OpenShift Serverless Logic Operator
 
 * Configure your {product-custom-resource-type} custom resource (CR) or Helm values file for Orchestrator
 

modules/orchestrator/con-orchestrator-plugin-dependencies-operator.adoc

@@ -44,4 +44,4 @@ The Operator automatically creates the required Role and _RoleBinding_ resource
 ====
 
 .Additional resources
-* link:https://github.com/redhat-developer/rhdh-operator/blob/release-1.7/docs/dynamic-plugins.md#dynamic-plugins-dependency-management[Dynamic plugins dependency management]
+* link:https://github.com/redhat-developer/rhdh-operator/blob/release-{product-version}/docs/dynamic-plugins.md#dynamic-plugins-dependency-management[Dynamic plugins dependency management]

modules/orchestrator/proc-enable-orchestrator-plugin.adoc

@@ -1,7 +1,7 @@
 :_mod-docs-content-type: PROCEDURE
 
 [id="proc-enable-orchestrator-plugin_{context}"]
-= Enabling the Orchestrator plugin using Operator
+= Enabling the Orchestrator plugin using the Operator
 
 You can enable the Orchestrator plugin in {product-very-short} by configuring dynamic plugins in your {product-custom-resource-type} custom resource (CR).
 
@@ -19,8 +19,14 @@ You can enable the Orchestrator plugin in {product-very-short} by configuring dy
   disabled: false
 ----
 +
+[NOTE]
+====
+When you enable the plugins, the pre-loaded plugin configuration are used.
+Additionally, the `ref: sonataflow` field installs the Openshift Serverless and Openshift Serverless Logic resources. This happens automatically when you are using the Operator.
+====
++
 .Example: Complete configuration of the Orchestrator plugin
-[source,yaml]
+[source,subs="+attributes,+quotes"]
 ----
 apiVersion: v1
 kind: ConfigMap
@@ -31,7 +37,7 @@ data:
       includes:
         - dynamic-plugins.default.yaml
       plugins:
-        - package: "@redhat/backstage-plugin-orchestrator@1.7.1"
+        - package: "@redhat/backstage-plugin-orchestrator@{orchestrator-plugin-version}"
           disabled: false
           pluginConfig:
             dynamicPlugins:
@@ -59,21 +65,21 @@ data:
                           if:
                             anyOf:
                               - IsOrchestratorCatalogTabAvailable
-        - package: "@redhat/backstage-plugin-orchestrator-backend-dynamic@1.7.1"
+        - package: "@redhat/backstage-plugin-orchestrator-backend-dynamic@{orchestrator-plugin-version}"
           disabled: false
           pluginConfig:
             orchestrator:
               dataIndexService:
                 url: http://sonataflow-platform-data-index-service
           dependencies:
             - ref: sonataflow
-        - package: "@redhat/backstage-plugin-scaffolder-backend-module-orchestrator-dynamic@1.7.1"
+        - package: "@redhat/backstage-plugin-scaffolder-backend-module-orchestrator-dynamic@{orchestrator-plugin-version}"
           disabled: false
           pluginConfig:
             orchestrator:
               dataIndexService:
                 url: http://sonataflow-platform-data-index-service
-        - package: "@redhat/backstage-plugin-orchestrator-form-widgets@1.7.1"
+        - package: "@redhat/backstage-plugin-orchestrator-form-widgets@{orchestrator-plugin-version}"
           disabled: false
           pluginConfig:
             dynamicPlugins:

modules/orchestrator/proc-install-rhdh-with-orchestrator-helm-cli.adoc

@@ -8,7 +8,7 @@ You can install {product} ({product-very-short}) on {ocp-short} with the Orchest
 .Prerequisites
 
 * You are logged in as an administrator and have access to the {product} Helm chart repository.
-* You can install the necessary infrastructures resources, such as SonataFlow, alongside {product-very-short} in the same namespace.
+* You can install the necessary infrastructures resources, such as other Openshift operators (OpenShift Serverless and OpenShift Serverless Logic), alongside {product-very-short} in the same namespace.
 +
 This is a one-off requirement and must be completed before enabling the Orchestrator plugin.