Incorporated Fabrice's comments

Author: pabel-rh

assemblies/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-enabling-users-to-use-topology-plugin.adoc[leveloffset=+1]
+
+include::modules/dynamic-plugins/proc-using-topology-plugin.adoc[leveloffset=+1]

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/assembly-using-topology-plugin.adoc[leveloffset=+1]

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

@@ -0,0 +1,25 @@
+[id="enabling-users-to-use-the-topology-plugin"]
+= Enabling 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,39 +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.
-
-== Enabling users to use the Topology plugin
-
-The Topology plugin is defining additional permissions. When link:{authorization-book-url}[{autorization-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 {autorization-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:
-
-== Using the Topology plugin
-
 .Prerequisites
 * Your {product} instance is installed and running.
 * You have installed the Topology plugin. 
 //For the installation process, see Installation.
-* You have enabled the users to use the Topology plugin.
-+
-[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.
+* You have link:{plugins-configure-book-url}#proc-enabling-users-to-use-topology-plugin.adoc[enabled the users to use the Topology plugin].
 
 .Procedure