[release-1.4] RHIDP-4485: Topology plugin code block formatting (redhat-developer#993)

* Removed the extra lines and formatted the code block

* minor change

* Fabrice's comments

* Incorporated Lindsey's comments

* Incorporated Fabrice's comments

* Incorporated Fabrice's comments

* replaced link to xref

* Minor changes

* Minor changes

---------

Co-authored-by: Priyanka Abel <[email protected]>

Author: openshift-cherrypick-robot

assemblies/dynamic-plugins/assembly-using-rhdh-plugins.adoc

@@ -20,4 +20,4 @@ include::../../artifacts/rhdh-plugins-reference/nexus-repository-manager/nexus-r
 include::../../artifacts/rhdh-plugins-reference/tekton/tekton-plugin-user.adoc[leveloffset=+1]
 
 // Topology
-include::../../modules/dynamic-plugins/proc-using-topology-plugin.adoc[leveloffset=+1]
+include::../../assemblies/dynamic-plugins/assembly-using-topology-plugin.adoc[leveloffset=+1]

assemblies/dynamic-plugins/assembly-using-topology-plugin.adoc

@@ -0,0 +1,10 @@
+:_mod-docs-content-type: ASSEMBLY
+:context: using-topology-plugin
+[id="{context}"]
+= Using the Topology plugin
+
+Topology is a front-end plugin that enables you to view the workloads as nodes that power any service on the Kubernetes cluster.
+
+include::../modules/dynamic-plugins/proc-enable-users-to-use-topology-plugin.adoc[leveloffset=+1]
+
+include::../modules/dynamic-plugins/proc-using-topology-plugin.adoc[leveloffset=+1]

modules/dynamic-plugins/proc-enable-users-to-use-topology-plugin.adoc

@@ -0,0 +1,25 @@
+[id="enable-users-to-use-the-topology-plugin"]
+= Enable users to use the Topology plugin
+
+The Topology plugin is defining additional permissions. When link:{authorization-book-url}[{authorization-book-title}] is enabled, to enable users to use the Topology plugin, grant them:
+
+* The `topology.view.read` `read` permission to view the Topology panel.
+* The `kubernetes.proxy` `use` permission to view the pod logs.
+* The `catalog-entity` `read` permission to view the {product} software catalog items.
+
+.Prerequisites
+* You are link:{authorization-book-url}#managing-authorizations-by-using-external-files[managing {authorization-book-title} by using external files].
+
+.Procedure
+* Add the following permission policies to your `rbac-policy.csv` file to create a `topology-viewer` role that has access to the Topology plugin features, and add the role to the users requiring this authorization:
++
+[source]
+----
+g, user:default/<YOUR_USERNAME>, role:default/topology-viewer
+p, role:default/topology-viewer, topology.view.read, read, allow <1>
+p, role:default/topology-viewer, kubernetes.proxy, use, allow <2>
+p, role:default/topology-viewer, catalog-entity, read, allow <3>
+----
+<1> Grants the user the ability to see the Topology panel. 
+<2> Grants the user the ability to view the pod logs. 
+<3> Grants the user the ability to see the catalog item.

modules/dynamic-plugins/proc-using-topology-plugin.adoc

@@ -1,20 +1,11 @@
+[id="using-the-topology-plugin"]
 = Using the Topology plugin
-Topology is a front-end plugin that enables you to view the workloads as nodes that power any service on the Kubernetes cluster.
 
 .Prerequisites
-* You have installed the Red Hat Developer Hub (RHDH).
+* Your {product} instance is installed and running.
 * You have installed the Topology plugin. 
 //For the installation process, see Installation.
-* If the RBAC permission framework is enabled, ensure to add the following permission policies in an external permission policies configuration file named `rbac-policy.csv` to allow the RBAC admins or your desired user(s)/group(s) to access the Topology plugin:
-+
-[source,bash]
-----
-g, user:default/<YOUR_USERNAME>, role:default/topology-viewer
-p, role:default/topology-viewer, topology.view.read, read, allow
-p, role:default/topology-viewer, kubernetes.proxy, use, allow
-p, role:default/topology-viewer, catalog-entity, read, allow
-p, role:default/topology-viewer, topology.view.read, read, allow grants the user the ability to see the Topology panel. p, role:default/topology-viewer, kubernetes.proxy, use, allow grants the user the ability to view the pod logs. p, role:default/topology-viewer, catalog-entity, read, allow grants the user the ability to see the catalog item.
-----
+* You have xref:enable-users-to-use-the-topology-plugin[enabled the users to use the Topology plugin].
 
 .Procedure
 
@@ -23,14 +14,14 @@ p, role:default/topology-viewer, topology.view.read, read, allow grants the user
 +
 image::rhdh-plugins-reference/topology-tab-user1.png[topology-user-1]
 
-. Select a node and a pop-up appears on the right side, which contains two tabs: *Details* and *Resources*.
-
-. The *Details* and *Resources* tabs contain the associated information and resources of the node.
+. Select a node and a pop-up appears on the right side that contains two tabs: *Details* and *Resources*.
++
+The *Details* and *Resources* tabs contain the associated information and resources for the node.
 +
 image::rhdh-plugins-reference/topology-tab-user2.png[topology-user-2]
 
-. Click on the *Open URL* button on the top of a node.
+. Click the *Open URL* button on the top of a node.
 +
 image::rhdh-plugins-reference/topology-tab-user3.png[topology-user-3]
 +
-When you click on the *Open URL* button, it allows you to access the associated *Ingresses* and runs your application in a new tab.
+Click the *Open URL* button to access the associated *Ingresses* and run your application in a new tab.