Move links in Prerequisites to Additional resources-Dynamic-plugins-and-importing-repositories

Author: GitHub Actions

modules/dynamic-plugins/proc-create-plugin-js-package.adoc

@@ -7,7 +7,7 @@ The derived dynamic plugin JavaScript packages must not be published to the publ
 ====
 
 .Prerequisites
-* You have exported a third-party dynamic plugin package. For more information, see xref:proc-export-third-party-plugins-rhdh_assembly-third-party-plugins[].
+* You have exported a third-party dynamic plugin package.
 
 .Procedure
 . Navigate to the `dist-dynamic` directory.
@@ -36,4 +36,9 @@ You can add the following to your `package.json` file before running the `export
 
 If you modify `publishConfig` after exporting the dynamic plugin, re-run the `export-dynamic-plugin` command to ensure the correct configuration is included.
 ====
---
+--
+
+[role="_additional-resources"]
+.Additional resources
+
+* link:https://docs.redhat.com/en/documentation/red_hat_developer_hub/1.6/html-single/installing_and_viewing_plugins_in_red_hat_developer_hub/index#proc-export-third-party-plugins-rhdh_assembly-third-party-plugins[Exporting third-party plugins in {product}]

modules/dynamic-plugins/proc-create-plugin-oci-image.adoc

@@ -3,7 +3,7 @@
 
 .Prerequisites
 * You have installed `podman` or `docker`.
-* You have exported a third-party dynamic plugin package. For more information, see xref:proc-export-third-party-plugins-rhdh_assembly-third-party-plugins[].
+* You have exported a third-party dynamic plugin package.
 
 .Procedure
 . Navigate to the plugin's root directory (not the `dist-dynamic` directory).
@@ -34,4 +34,9 @@ docker push quay.io/example/image:v0.0.1
 ----
 
 The output of the `package-dynamic-plugins` command provides the plugin's path for use in the `dynamic-plugin-config.yaml` file.
---
+--
+
+[role="_additional-resources"]
+.Additional resources
+
+* link:https://docs.redhat.com/en/documentation/red_hat_developer_hub/1.6/html-single/installing_and_viewing_plugins_in_red_hat_developer_hub/index#proc-export-third-party-plugins-rhdh_assembly-third-party-plugins[Exporting third-party plugins in {product}]

modules/dynamic-plugins/proc-create-plugin-tgz-file.adoc

@@ -2,7 +2,7 @@
 = Creating a TGZ file with dynamic packages
 
 .Prerequisites
-* You have exported a third-party dynamic plugin package. For more information, see xref:proc-export-third-party-plugins-rhdh_assembly-third-party-plugins[].
+* You have exported a third-party dynamic plugin package.
 
 .Procedure
 . Navigate to the `dist-dynamic` directory.
@@ -67,4 +67,9 @@ oc new-app --image-stream=plugin-registry
 plugins:
   - package: http://plugin-registry:8080/backstage-plugin-myplugin-1.9.6.tgz
 ----
---
+--
+
+[role="_additional-resources"]
+.Additional resources
+
+* link:https://docs.redhat.com/en/documentation/red_hat_developer_hub/1.6/html-single/installing_and_viewing_plugins_in_red_hat_developer_hub/index#proc-export-third-party-plugins-rhdh_assembly-third-party-plugins[Exporting third-party plugins in {product}]

modules/dynamic-plugins/proc-enable-plugins-rhdh-container-image.adoc

@@ -6,7 +6,7 @@ In the {product-very-short} container image, a set of dynamic plugins is preload
 You can enable and configure the plugins in the {product-very-short} container image, including how to manage the default configuration, set necessary environment variables, and ensure the proper functionality of the plugins within your application.
 
 .Prerequisites
-* You have access to the link:https://github.com/janus-idp/backstage-showcase/blob/main/dynamic-plugins.default.yaml[`dynamic-plugins.default.yaml`] file, which lists all preloaded plugins and their default configuration.
+* You have access to the `dynamic-plugins.default.yaml` file, which lists all preloaded plugins and their default configuration.
 * You have deployed the {product-very-short} application, and have access to the logs of the `install-dynamic-plugins` init container.
 * You have the necessary permissions to modify plugin configurations and access the application environment.
 * You have identified and set the required environment variables referenced by the plugin's default configuration. These environment variables must be defined in the Helm Chart or Operator configuration.
@@ -34,3 +34,8 @@ For more information about how to configure dynamic plugins in {product-short},
 .Verification
 . Restart the {product-very-short} application and verify that the plugin is successfully activated and configured.
 . Verify the application logs for confirmation and ensure the plugin is functioning as expected.
+
+[role="_additional-resources"]
+.Additional resources
+
+* link:https://github.com/janus-idp/backstage-showcase/blob/main/dynamic-plugins.default.yaml[`dynamic-plugins.default.yaml` file]

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

@@ -8,7 +8,7 @@ The Topology plugin is defining additional permissions. When link:{authorization
 * 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].
+* You are 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:
@@ -23,4 +23,9 @@ 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.
+<3> Grants the user the ability to see the catalog item.
+
+[role="_additional-resources"]
+.Additional resources
+
+* link:{authorization-book-url}#managing-authorizations-by-using-external-files[Managing {authorization-book-title} by using external files]

modules/dynamic-plugins/proc-export-third-party-plugins-rhdh.adoc

@@ -6,7 +6,7 @@ To use plugins in {product}, you can export plugins as derived dynamic plugin pa
 .Prerequisites
 * The `@janus-idp/cli` package is installed. Use the latest version (`@latest` tag) for compatibility with the most recent features and fixes.
 * Node.js and NPM is installed and configured.
-* The third-party plugin is compatible with your {product} version. For more information, see link:https://github.com/redhat-developer/rhdh/blob/main/docs/dynamic-plugins/versions.md[Version compatibility matrix].
+* The third-party plugin is compatible with your {product} version. For more information, see the Version compatibility matrix.
 * The third-party plugin must have a valid `package.json` file in its root directory, containing all required metadata and dependencies.
 +
 --
@@ -124,4 +124,7 @@ The derived dynamic plugin JavaScript packages must not be published to the publ
 ====
 --
 
+[role="_additional-resources"]
+.Additional resources
 
+* link:https://github.com/redhat-developer/rhdh/blob/main/docs/dynamic-plugins/versions.md[Version compatibility matrix]

modules/dynamic-plugins/proc-load-plugin-js-package.adoc

@@ -2,9 +2,7 @@
 = Loading a plugin packaged as a JavaScript package
 
 .Prerequisites
-* The third-party plugin is packaged as a dynamic plugin in a JavaScript package. 
-+
-For more information about packaging a third-party plugin, see xref:assembly-package-publish-third-party-dynamic-plugin[].
+* The third-party plugin is packaged as a dynamic plugin in a JavaScript package.
 
 .Procedure
 . Run the following command to obtain the integrity hash from the NPM registry:
@@ -65,4 +63,9 @@ stringData:
 `_<release_name>_-dynamic-plugins-npmrc`
 --
 
-. To apply the changes, restart the {product-very-short} application.
+. To apply the changes, restart the {product-very-short} application.
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:assembly-package-publish-third-party-dynamic-plugin[Packaging a third-party plugin]

modules/dynamic-plugins/proc-load-plugin-oci-image.adoc

@@ -2,9 +2,7 @@
 = Loading a plugin packaged as an OCI image
 
 .Prerequisites
-* The third-party plugin is packaged as a dynamic plugin in an OCI image. 
-+
-For more information about packaging a third-party plugin, see xref:assembly-package-publish-third-party-dynamic-plugin[].
+* The third-party plugin is packaged as a dynamic plugin in an OCI image.
 
 .Procedure
 . To retrieve plugins from an authenticated registry, complete the following steps:
@@ -55,3 +53,8 @@ plugins:
 ----
 --
 . To apply the changes, restart the {product-very-short} application.
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:assembly-package-publish-third-party-dynamic-plugin[Packaging a third-party plugin]

modules/dynamic-plugins/proc-load-plugin-tgz-file.adoc

@@ -2,9 +2,7 @@
 = Loading a plugin packaged as a TGZ file
 
 .Prerequisites
-* The third-party plugin is packaged as a dynamic plugin in a TGZ file. 
-+
-For more information about packaging a third-party plugin, see xref:assembly-package-publish-third-party-dynamic-plugin[].
+* The third-party plugin is packaged as a dynamic plugin in a TGZ file.
 
 .Procedure
 
@@ -21,4 +19,9 @@ plugins:
 ----
 --
 
-. To apply the changes, restart the {product-very-short} application.
+. To apply the changes, restart the {product-very-short} application.
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:assembly-package-publish-third-party-dynamic-plugin[Packaging a third-party plugin]

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

@@ -3,9 +3,9 @@
 
 .Prerequisites
 * Your {product} instance is installed and running.
-* You have installed the Topology plugin. 
+* You have installed the Topology plugin.
 //For the installation process, see Installation.
-* You have xref:enable-users-to-use-the-topology-plugin[enabled the users to use the Topology plugin].
+* You have enabled the users to use the Topology plugin.
 
 .Procedure
 
@@ -25,3 +25,8 @@ image::rhdh-plugins-reference/topology-tab-user2.png[topology-user-2]
 image::rhdh-plugins-reference/topology-tab-user3.png[topology-user-3]
 +
 Click the *Open URL* button to access the associated *Ingresses* and run your application in a new tab.
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:enable-users-to-use-the-topology-plugin[Enabling the users to use the Topology plugin]