[release-1.7] RHIDP-8815: Updates on the Orchestrator documentation into RHDH (#1353)

* Update the orchestrator section

* Update the orchestrator section

---------

Co-authored-by: GitHub Actions <[email protected]>

Author: openshift-cherrypick-robot

assemblies/assembly-orchestrator-rhdh.adoc

@@ -30,10 +30,10 @@ To start using Orchestrator in {product-very-short}, you must:
 include::modules/orchestrator/con-supported-architecture-for-orchestrator.adoc[leveloffset=+1]
 
 // provisioning plugin dependencies
-include::modules/orchestrator/con-understanding-orchestrator-plugin-dependencies-operator.adoc[leveloffset=+1]
+include::modules/orchestrator/con-orchestrator-plugin-dependencies-operator.adoc[leveloffset=+1]
 
 // installing the components for the orchestrator plugin
-include::modules/orchestrator/con-install-components-orchestrator-plugin.adoc[leveloffset=+1]
+include::modules/orchestrator/con-orchestrator-plugin-components.adoc[leveloffset=+1]
 
 // Orchestrator Infrastructure for {product} Helm chart
 include::modules/orchestrator/proc-helm-install-components-orchestrator-plugin.adoc[leveloffset=+2]

modules/orchestrator/con-install-components-orchestrator-plugin.adoc renamed to modules/orchestrator/con-orchestrator-plugin-components.adoc

@@ -1,5 +1,5 @@
 :_mod-docs-content-type: CONCEPT
-[id="con-install-components-orchestrator-plugin_{context}"]
+[id="con-orchestrator-plugin-components.adoc_{context}"]
 = Orchestrator plugin components on {ocp-short}
 
 To run the Orchestrator plugin successfully on {ocp-short}, you must first install the following required components:

modules/orchestrator/con-understanding-orchestrator-plugin-dependencies-operator.adoc renamed to modules/orchestrator/con-orchestrator-plugin-dependencies-operator.adoc

@@ -1,13 +1,13 @@
 :_mod-docs-content-type: CONCEPT
-[id="con-understanding-orchestrator-plugin-dependencies-operator_{context}"]
-= Understanding Orchestrator plugin dependencies for Operator installation
+[id="con-orchestrator-plugin-dependencies-operator.adoc_{context}"]
+= Orchestrator plugin dependencies for Operator installation
 
-The Orchestrator plugin in {product-very-short} requires components such as SonataFlow and supporting network policies to run. When you enable the plugin in your {product-custom-resource-type} custom resource (CR), the Operator automatically provisions these dependencies for you:
+When you enable the Orchestrator plugin in your {product-custom-resource-type} custom resource (CR), the Operator automatically provisions the following required dependencies:
 
 * A `SonataflowPlatform` CR
 * `NetworkPolicies` that allow traffic between infrastructure resources (Knative, Serverless Logic Operator), monitoring traffic, and intra-namespace traffic
 
-The `orchestrator-backend` plugin uses the `sonataflow-platform-data-index-service`, which the `SonataFlowPlatform` CR creates to communicate with the SonataFlow platform.
+The Orchestrator plugin requires these components to run. For example, to communicate with the SonataFlow platform, the Orchestrator plugin uses the `sonataflow-platform-data-index-service`, which is created by the `SonataFlowPlatform` CR.
 
 [IMPORTANT]
 ====

modules/orchestrator/proc-helper-script-overview.adoc

@@ -2,7 +2,7 @@
 [id="proc-helper-script-overview.adoc_{context}"]
 = Installing components using the `{product-very-short}` helper script
 
-You can use the `{product-very-short}` helper script `plugin-infra.sh` to quickly install the OpenShift Serverless infrastructure and Openshift Serverless Logic infrastructure required by the Orchestrator plugin.
+You can use the {product-very-short} helper script `plugin-infra.sh` to quickly install the OpenShift Serverless infrastructure and Openshift Serverless Logic infrastructure required by the Orchestrator plugin.
 
 [WARNING]
 ====

modules/orchestrator/proc-manual-install-components-orchestrator-plugin.adoc

@@ -1,12 +1,12 @@
 :mod-docs-content-type: PROCEDURE
 [id="proc-manual-install-orchestrator-plugin_{context}"]
-= Installing Orchestrator components on {ocp-short}
+= Installing Orchestrator components manually on {ocp-short}
 
 Use manual installation when you want full control of the setup process and component versions. Manual installation method focuses on setting up the underlying infrastructure.
 
 .Procedure
 
-. Install the OpenShift Serverless components. If you wish to manually install the OpenShift Serverless components, follow the instructions in the link:https://docs.redhat.com/en/documentation/red_hat_openshift_serverless/1.36[Red Hat OpenShift Serverless] documentation.
+. Install the OpenShift Serverless components manually by following the instructions in the link:https://docs.redhat.com/en/documentation/red_hat_openshift_serverless/1.36[Red Hat OpenShift Serverless] documentation.
 
 . You must also configure workflow persistence to prevent workflow context from being lost when the Pod restarts. You can do this configuration at the namespace level using the `SonataFlowPlatform` or `SonataFlow` custom resources (CR). For detailed instructions on configuring persistence using the `SonataFlowPlatform` or `SonataFlow` custom resources, see link:https://docs.redhat.com/en/documentation/red_hat_openshift_serverless/1.36/html-single/serverless_logic/index#serverless-logic-managing-persistence[Managing workflow persistence].