RHIDP-5422: Add more conceptual info about preinstalled and external add-ons and how they are imported by using dynamic plugins

Author: linfraze

assemblies/assembly-techdocs-addons.adoc

@@ -31,4 +31,4 @@ The following table describes the TechDocs add-ons that are available for {produ
 //future release | Expand or collapse the subtitles in the TechDocs navigation menu and keep your preferred state between documentation sites.
 |===
 
-You can use a dynamic plugin to import a TechDocs add-on. TechDocs add-ons are enabled at the plugin level, therefore, enabling a plugin enables all of the TechDocs add-ons in the specified plugin package. The preinstalled and external add-ons supported by {company} are imported by the `backstage-plugin-techdocs-module-addons-contrib` plugin package. Since the `disabled` status is set at the plugin level, the `disabled` status of the plugin package applies to all of the TechDocs add-ons imported by that that package.
+You can use a dynamic plugin to import a TechDocs add-on. TechDocs add-ons are enabled at the plugin level, therefore, enabling a plugin enables all of the TechDocs add-ons in the specified plugin package. The preinstalled and external add-ons supported by {company} are imported by the `backstage-plugin-techdocs-module-addons-contrib` plugin package. Since the `disabled` status is set at the plugin level, the `disabled` status of the plugin package applies to all of the TechDocs add-ons imported by that package.

modules/techdocs/proc-techdocs-addon-install-helm.adoc

@@ -6,7 +6,9 @@
 [id="proc-techdocs-addon-install-helm_{context}"]
 == Installing and configuring an external TechDocs add-on using the Helm chart
 
-You can use the {product} Helm chart to install a TechDocs add-on on your {product} instance as a dynamic plugin.
+You can use a dynamic plugin to import TechDocs add-ons into your TechDocs plugin. If you use the {product} Helm chart to install the dynamic plugin, you can add TechDocs add-ons to the plugin package in your Helm chart.
+
+Preinstalled add-ons, such as `ReportIssue`, are included in the default `backstage-plugin-techdocs-module-addons-contrib` package configuration. External add-ons that are supported by {company-name} are installed by manually adding them to the `techdocsAddons` section of the configuration file.
 
 .Prerequisites
 * The TechDocs plugin is installed and enabled.
@@ -34,13 +36,7 @@ global:
                 techdocsAddons:
                   - importName: ReportIssue
 ----
-+
-[NOTE]
-====
-Preinstalled add-ons, such as `ReportIssue`, are included in the default package configuration. Additional add-ons are installed by manually adding them to the configuration file.
-====
-
-. In the `techdocsAddons` section of the Helm chart, add `importName: _<external_techdocs_add-on>` for each external TechDocs add-on that you want to add from the specified plugin package. For example:
+. In the `techdocsAddons` section of the Helm chart, add `importName: _<external_techdocs_add-on>_` for each external TechDocs add-on that you want to add from the specified plugin package. For example:
 +
 [source,yaml,subs="+quotes,+attributes"]
 ----

modules/techdocs/proc-techdocs-addon-install-operator.adoc

@@ -6,11 +6,9 @@
 [id="proc-techdocs-addon-install-operator_{context}"]
 == Installing and configuring an external TechDocs add-on using the Operator
 
-You can use the {product} Operator to install a TechDocs add-on on your {product} instance as a dynamic plugin.
+You can use a dynamic plugin to import TechDocs add-ons into your TechDocs plugin. If you use the {product} Operator to install the dynamic plugin, you can add TechDocs add-ons to the plugin package in your ConfigMap.
 
-.Prerequisites
-* An administrator has installed the {product} Operator.
-* The TechDocs plugin is installed and enabled.
+Preinstalled add-ons, such as `ReportIssue`, are included in the default `backstage-plugin-techdocs-module-addons-contrib` package configuration. External add-ons that are supported by {company-name} are installed by manually adding them to the `techdocsAddons` section of the configuration file.
 
 .Procedure
 
@@ -38,12 +36,7 @@ data:
                 techdocsAddons:
                   - importName: ReportIssue
 ----
-+
-[NOTE]
-====
-Preinstalled add-ons, such as `ReportIssue`, are included in the default package configuration. Additional add-ons are installed by manually adding them to the configuration file.
-====
-. In the `techdocsAddons` section of the ConfigMap, add `importName: _<external_techdocs_add-on>` for each external TechDocs add-on that you want to add from the specified plugin package. For example:
+. In the `techdocsAddons` section of the ConfigMap, add `importName: _<external_techdocs_add-on>_` for each external TechDocs add-on that you want to add from the specified plugin package. For example:
 +
 [source,yaml,subs="+quotes,+attributes"]
 ----