RHIDP-3440-reference 1.3 Add tables (#564)

Author: Gerry-Forde

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

@@ -1,31 +1,21 @@
 [id="rhdh-installing-dynamic-plugins"]
 = Dynamic plugin installation
+
 The dynamic plugin support is based on the backend plugin manager package, which is a service that scans a configured root directory (`dynamicPlugins.rootDirectory` in the app config) for dynamic plugin packages and loads them dynamically.
 
 You can use the dynamic plugins that come preinstalled with {product} or install external dynamic plugins from a public NPM registry.
 
-//viewing installed plugins
-// Viewing installed plugins
-include::../modules/dynamic-plugins/proc-viewing-installed-plugins.adoc[leveloffset=+1]
-//preinstalled plugins
-
 // Preinstalled plugins
 include::../modules/dynamic-plugins/con-preinstalled-dynamic-plugins.adoc[leveloffset=+1]
-// include::../modules/dynamic-plugins/rhdh-supported-plugins.adoc[leveloffset=+2]
-
-//configure dynamic plugins - moved from admin guide
-//include::../modules/dynamic-plugins/rhdh-supported-plugins.adoc[leveloffset=+2]
 
 // Dynamic plugins tables
-[id="rhdh-supported-plugins"]
-== Preinstalled dynamic plugin descriptions and details
 
 // Red Hat Generally Available supported plugins
 include::../modules/dynamic-plugins/ref-rh-supported-plugins.adoc[leveloffset=+3]
 
 [NOTE]
 ====
-* For more information about configuring Keycloak, see xref:rhdh-keycloak_{context}[Installation and configuration of Keycloak].
+* For more information about configuring KeyCloak, see link:{plugins-configure-book-url}[{plugins-configure-book-title}].
 
 * For more information about configuring TechDocs, see link:{LinkAdminGuide}#assembly-techdocs-plugin_{context}[Configuring the TechDocs plugin in {product}].
 ====
@@ -39,7 +29,7 @@ include::../modules/dynamic-plugins/ref-rh-tech-preview-plugins.adoc[leveloffset
 
 [NOTE]
 ====
-* A new Technology Preview plugin for Red Hat Ansible Automation Platform (RHAAP) is available, which replaces this older one. See link:{LinkPluginsGuide}#rhdh-compatible-plugins[Other compatible plugins] in the _{NameOfPluginsGuide} guide_ for further details.
+* A new Technology Preview plugin for Red Hat Ansible Automation Platform (RHAAP) is available, which replaces this older one. See link:{LinkPluginsGuide}#rhdh-compatible-plugins[Other installable plugins] in the _{NameOfPluginsGuide} guide_ for further details. See xref:rhdh-compatible-plugins[Dynamic plugins support matrix]. 
 ====
 
 // Community plugins
@@ -48,19 +38,4 @@ include::../modules/dynamic-plugins/ref-community-plugins.adoc[leveloffset=+4]
 
 // Red Hat compatible plugins
 [id="rhdh-compatible-plugins"]
-include::../modules/dynamic-plugins/ref-rh-compatible-plugins.adoc[leveloffset=+1]
-
-
-// Configure dynamic plugins - moved from admin guide
-include::../modules/dynamic-plugins/proc-config-dynamic-plugins-rhdh-operator.adoc[leveloffset=+1]
-
-//helm installed plugins
-// Helm installed plugins
-include::../modules/dynamic-plugins/con-install-dynamic-plugin-helm.adoc[leveloffset=+1]
-include::../modules/dynamic-plugins/proc-obtaining-integrity-checksum.adoc[leveloffset=+2]
-include::../modules/dynamic-plugins/ref-example-dynamic-plugin-helm-installations.adoc[leveloffset=+2]
-include::../modules/dynamic-plugins/proc-rhdh-example-external-dynamic-plugins.adoc[leveloffset=+2]
-//include::../modules/dynamic-plugins/proc-rhdh-installing-external-dynamic-plugins-airgapped.adoc[leveloffset=+1]
-include::../modules/dynamic-plugins/proc-using-custom-npm-registry.adoc[leveloffset=+1]
-//basic plugin configuration
-include::../modules/dynamic-plugins/con-basic-config-dynamic-plugins.adoc[leveloffset=+1]
+include::../modules/dynamic-plugins/ref-rh-compatible-plugins.adoc[leveloffset=+1]

modules/dynamic-plugins/con-preinstalled-dynamic-plugins.adoc

@@ -2,7 +2,8 @@
 
 = Preinstalled dynamic plugins
 
-{product} is preinstalled with a selection of dynamic plugins. For a complete list of dynamic plugins that are included in this release of {product-short}, see the xref:rhdh-supported-plugins[Dynamic plugins support matrix].
+{product} is preinstalled with a selection of dynamic plugins. 
+//For a complete list of dynamic plugins that are included in this release of {product-short}, see the xref:rhdh-supported-plugins[Dynamic plugins support matrix].
 
 The following preinstalled dynamic plugins are enabled by default:
 
@@ -12,8 +13,6 @@ The following preinstalled dynamic plugins are enabled by default:
 * `@backstage/plugin-techdocs-backend`
 * `@backstage/plugin-techdocs`
 
-The dynamic plugins that require custom configuration are disabled by default.
-
 Upon application startup, for each plugin that is disabled by default, the `install-dynamic-plugins init container` within the {product-short} pod log displays a message similar to the following:
 
 [source,yaml]

modules/dynamic-plugins/ref-rh-compatible-plugins.adoc

@@ -1,10 +1,34 @@
 // This page is generated! Do not edit the .adoc file, but instead run rhdh-supported-plugins.sh to regen this page from the latest plugin metadata.
 // cd /path/to/rhdh-documentation; ./modules/dynamic-plugins/rhdh-supported-plugins.sh; ./build/scripts/build.sh; google-chrome titles-generated/main/plugin-rhdh/index.html
 
-= Other compatible installable plugins 
+= Other installable plugins 
 
-{product-very-short} provides Technology Preview support for the following compatible plugins, which are not preinstalled and must be enabled from an external source:
+The following Technology Preview plugins are not preinstalled and must be installed from an external source:
 
+[%header,cols=4*]
+|===
+|*Name* |*Plugin*|*Version* |*Installation Details*
+
+|Ansible Automation Platform Frontend|`https://access.redhat.com/downloads/content/480/ver=2.4/rhel---9/2.4/x86_64/product-software[@ansible/plugin-backstage-rhaap]` |1.0.0
+| https://docs.redhat.com/en/documentation/red_hat_ansible_automation_platform/2.4/html/installing_ansible_plug-ins_for_red_hat_developer_hub[Learn more]
+
+|Ansible Automation Platform
+| `https://access.redhat.com/downloads/content/480/ver=2.4/rhel---9/2.4/x86_64/product-software[@ansible/plugin-backstage-rhaap-backend]` |1.0.0 |
+
+|Ansible Automation Platform Scaffolder Backend
+|`https://access.redhat.com/downloads/content/480/ver=2.4/rhel---9/2.4/x86_64/product-software[@ansible/plugin-scaffolder-backend-module-backstage-rhaap]` |1.0.0 |
+
+
+|Orchestrator Frontend|`https://www.npmjs.com/package/@janus-idp/backstage-plugin-orchestrator[@janus-idp/backstage-plugin-orchestrator]` |1.22.6| https://www.parodos.dev/1.2-rc/docs/[Learn more]
+
+|Orchestrator Backend
+|`https://www.npmjs.com/package/@janus-idp/backstage-plugin-orchestrator-backend-dynamic[@janus-idp/backstage-plugin-orchestrator-backend-dynamic]` |1.22.9 |
+
+
+|===
+
+// Without description - for consistency i.e. no descriptions in other table and we provide a 'Learn more' link to plugin documentation for users' convenience.
+////
 [%header,cols=5*]
 |===
 |*Name* |*Description*|*Plugin*|*Version* |*Installation Details*
@@ -31,6 +55,7 @@
 
 
 |===
+////
 
 [NOTE]
 ====

titles/plugins-rhdh-reference/docinfo.xml

@@ -1,7 +1,7 @@
 <title>{title}</title>
 <productname>{product}</productname>
 <productnumber>{product-version}</productnumber>
-<subtitle>{subtitle}
+<subtitle>
 </subtitle>
 <abstract>
     <para>{abstract}</para>

titles/plugins-rhdh-reference/master.adoc

@@ -3,8 +3,8 @@ include::artifacts/attributes.adoc[]
 :doctype: book
 :imagesdir: images
 
-:title: Dynamic plugins in {product}
+:title: Dynamic plugins reference
 :subtitle: Working with plugins in {product-very-short}
 :abstract: {product} is preinstalled with a selection of dynamic plugins that users can enable and configure to extend {product-very-short} functionality.
 
-include::assemblies/dynamic-plugins/assembly-reference-rhdh-plugins.adoc[]
+include::assemblies/dynamic-plugins/assembly-rhdh-installing-dynamic-plugins.adoc[]