Merge branch 'main' into feat/rhidp-7526-migrate-lifecycle-metadata

Author: polasudo

artifacts/attributes.adoc

@@ -167,4 +167,5 @@
 :dynamic-plugins-reference-book-title: Dynamic plugins reference
 
 
-
+:adoption-insights-url: https://docs.redhat.com/en/documentation/red_hat_developer_hub/{product-version}/html-single/adoption_insights_in_red_hat_developer_hub/index
+:adoption-insights-title: Adoption Insights in {product}

modules/observe/adoption-insights/proc-configure-adoption-insights.adoc

@@ -2,4 +2,19 @@
 [id="proc-configure-adoption-insights_{context}"]
 = Configuring the Adoption Insights plugin in {product}
 
-The Adoption Insights plugin is preinstalled and enabled on a {product-short} instance by default. You can disable or enable the Adoption Insights plugin and change other parameters, by configuring the `app-config` ConfigMap, which is created by the {product} Helm chart or Operator.
+The Adoption Insights plugin is preinstalled and enabled on a {product-short} instance by default. You can disable or enable the Adoption Insights plugin and change other parameters, by configuring the `app-config` ConfigMap, which is created by the {product} Helm chart or Operator.
+
+[IMPORTANT]
+====
+If you used the Developer Preview of the Adoption Insights plugin and configured the feature manually, you must remove those earlier configuration changes as they are no longer required.
+
+In your dynamic plugins ConfigMap, for example: `dynamic-plugins-rhdh.yaml`, update the `package-disabled` value of the plugin to `false` as shown in the following example:
+
+.`dynamic-plugins.yaml` fragment
+[source,yaml]
+----
+plugins:
+  - package: ./dynamic-plugins/dist/backstage-community-plugin-analytics-provider-segment
+    disabled: false
+----
+====

modules/observe/adoption-insights/proc-customize-adoption-insights.adoc

@@ -8,22 +8,6 @@
 
 You can customize the Adoption Insights plugin to suit your needs by disabling or re-enabling it, and adjusting other settings as needed.
 
-
-[IMPORTANT]
-====
-If you used the developer preview of the Adoption Insights plugin and configured the feature manually, you must remove those earlier configuration changes as they are no longer required.
-
-In your dynamic plugins ConfigMap, for example: `dynamic-plugins-rhdh.yaml`, update the `package-disabled` value of the plugin to `false` as shown in the following example:
-
-.`dynamic-plugins.yaml` fragment
-[source,yaml]
-----
-plugins:
-  - package: ./dynamic-plugins/dist/backstage-community-plugin-analytics-provider-segment
-    disabled: false
-----
-====
-
 .Procedure
 
 * To customize `maxBufferSize`, `flushInterval`, `debug`, and `licensedUsers` in the Adoption Insights plugin, in your {product} `app-config.yaml` file, update the relevant settings as shown in the following code:

modules/release-notes/ref-release-notes-new-features.adoc

@@ -89,8 +89,7 @@ For more information, see link:{configuring-book-url}#HighAvailability[_Configur
 In this release, the Adoption Insights plugin is fully supported and enabled by default. The Adoption Insights plugin provides key metrics and trends to help you understand {product-short} usage. 
 
 If you have an existing Adoption Insights plugin custom configuration with GitHub Container registry images already set up, you can upgrade to the latest version to omit configurations using GitHub Container registry images.
-
-For more information, see link:https://docs.redhat.com/en/documentation/red_hat_developer_hub/1.6/html/adoption_insights_in_red_hat_developer_hub/index[Adoption Insights in Red Hat Developer Hub].
+For more information, see link:{adoption-insights-url}#proc-configure-adoption-insights_title-adoption-insights[Configuring the {adoption-insights-title}].
 
 [id="feature-rhidp-7663"]
 == {product-short} community plugins updated to Backstage 1.39