RHIDP-6544 - Document how users can install and configure plugins from Marketplace in RHDH

Author: Gerry-Forde

assemblies/dynamic-plugins/assembly-extensions-plugins.adoc

@@ -29,8 +29,11 @@ include::../modules/dynamic-plugins/proc-viewing-installed-plugins.adoc[leveloff
 // Searching and filtering Extensions
 include::../modules/dynamic-plugins/con-catalog-searching-and-filtering.adoc[leveloffset=+1]
 
-// Viewing a plugin
-include::../modules/dynamic-plugins/ref-catalog-plugin.adoc[leveloffset=+2]
+// Viewing a plugin - screenshots added post 1.5 GA, so this section is no longer necessary
+// include::../modules/dynamic-plugins/ref-catalog-plugin.adoc[leveloffset=+2]
+
+// Installing a plugin
+include::../modules/dynamic-plugins/proc-extensions-installing.adoc[leveloffset=+1]
 
 // Disabling Extensions 
 include::../modules/dynamic-plugins/proc-extensions-disabling.adoc[leveloffset=+1]

images/rhdh-plugins-reference/rhdh-extensions-tekton-card.png

@@ -0,0 +1,44 @@
+[id="rhdh-extensions-plugins-installing_{context}"]
+= Installing a plugin by using Extensions
+You can install a plugin and configure it from Extensions.
+
+
+.Procedure
+. Use the search bar in the header to search for the plugin that you wish to install and click on the card. For example, search for Tekton and click on the Pipelines With Tekton card.
++
+image::rhdh-plugins-reference/rhdh-extensions-tekton-card.png[Extensions catalog with Tekton card]
+. On the plugin details page, you can review more information about the plugin and how to install it in{product-very-short}. To install the plugin click *Install*.
++
+image::rhdh-plugins-reference/rhdh-extensions-tekton-details.png[Extensions catalog with Tekton details]
+. On the indstall plugins page, click on the *About the plugin* tab to  text-editor will appear which will be used to update your {product-very-short} dynamic plugins configuration. with installation instructions. The installation instructions and default configuration are also displayed. 
++
+image::rhdh-plugins-reference/rhdh-extensions-tekton-editor-1.png[Extensions catalog with plugin editor template]
+. Click Apply to copy the default configuration to the text-editor.
+. Click on the copy icon to copy the configuration from the text editor to your `app-config.yaml` file.
++
+image::rhdh-plugins-reference/rhdh-extensions-tekton-editor-2.png[Extensions catalog with Tekton configuration]
+
+.Next steps
+TBC
+
+.Verification
+TBC
+
+////
+. To disable the the Extensions feature plugins, edit your `dynamic-plugins.yaml` with the following content.
++
+.`dynamic-plugins.yaml` fragment
+[source,yaml]
+----
+plugins:
+  - package: ./dynamic-plugins/dist/red-hat-developer-hub-backstage-plugin-marketplace
+    disabled: true
+  - package: ./dynamic-plugins/dist/red-hat-developer-hub-backstage-plugin-catalog-backend-module-marketplace-dynamic
+    disabled: true
+  - package: ./dynamic-plugins/dist/red-hat-developer-hub-backstage-plugin-marketplace-backend-dynamic
+    disabled: true
+----
+
+[NOTE]
+If you disable the Extensions feature plugins, the *Catalog* and *Installed* tabs will also be removed. You can still view installed plugins by clicking on *Administration* > *Extensions*.
+////