Made a few changes

Author: pabel-rh

assemblies/assembly-adoption-insights.adoc

@@ -1,16 +1,30 @@
 [id="assembly-adoption-insights"]
 = Adoption Insights
 
+The {product} instance comes with the Adoption Insights plugin preinstalled and enabled by default.
 
-//about adoption insights
-include::modules/observe/adoption-insights/con-about-adoption-insights.adoc[leveloffset=+1]
+As organizations generate an increasing number of data events, there is a growing need for detailed insights into the adoption and engagement metrics of the internal developer portal. These insights help platform engineers make data-driven decisions to improve its performance, usability, and translate them into actionable insights. 
 
-//installing adoption insights
-include::modules/observe/adoption-insights/proc-install-adoption-insights.adoc[leveloffset=+1]
+You can use Adoption Insights in {product} to visualize key metrics and trends to get information about the usage of {product-short} in your organization. The information provided by Adoption Insights in {product-short} pinpoints areas of improvement, highlights popular features, and evaluates progress toward adoption goals. You can also monitor user growth against license users and identify trends over time.
+
+The Adoption Insights dashboard in {product-short} includes the following cards:
+
+* *Active users*
+* *Total nuber of users*
+* *Top catalog entities*
+* *Top 3 templates*
+* *Top 3 techdocs*
+* *Top 3 plugins*
+* *Portal searches*
+
+image::rhdh-plugins-reference/adoption-insights.jpg[adoption insights]
 
 //configuring adoption insights
 include::modules/observe/adoption-insights/proc-configure-adoption-insights.adoc[leveloffset=+1]
 
+//disabling adoption insights
+include::modules/observe/adoption-insights/proc-disable-adoption-insights.adoc[leveloffset=+1]
+
 //using adoption insights
 include::modules/observe/adoption-insights/proc-using-adoption-insights.adoc[leveloffset=+1]
 

modules/observe/adoption-insights/con-about-adoption-insights.adoc

@@ -2,24 +2,9 @@
 [id="proc-configure-adoption-insights_{context}"]
 = Configuring the Adoption Insights plugin in {product}
 
-You can enable the Adoption Insights plugin by configuring the {product} Helm chart or the {product} Operator ConfigMap.
+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 {product} Helm chart or the {product} Operator ConfigMap.
 
-.Procedure
-
-* To configure the Adoption Insights plugin in {product-short}, in your {product} `app-config.yaml` file, add the following code:
-+
-.`app-config.yaml` fragment
-[source,terminal]
-----
-app:
-  analytics:
-    adoptionInsights: 
-      maxBufferSize: 20 <1>
-      flushInterval: 5000 <2>
-      debug: false <3>
-      licensedUsers: 2000 <4>
-----
-<1> (Optional) Specifies the maximum buffer size for event batching. The default value is `20`. 
-<2> (Optional) Specifies the flush interval in milliseconds for event batching. The default value is `5000ms`.
-<3> (Optional) The default value is `false`.
-<4> (Optional) Specifies the maximum number of licensed users who can access the RHDH instance. The default value is `100`.
+[IMPORTANT]
+====
+{product} includes a built-in Adoption Insights builder that generates static HTML documentation from your codebase. However, the default basic setup of the local builder is not intended for production.
+====

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

@@ -3,16 +3,16 @@
 // * assemblies/assembly-rhdh-observability.adoc
 
 :_mod-docs-content-type: PROCEDURE
-[id="proc-install-adoption-insights_{context}"]
-= Installing the Adoption Insights plugin in {product}
+[id="proc-disable-adoption-insights_{context}"]
+= Disabling the Adoption Insights plugin in {product}
 
-For the {product} Adoption Insights plugin, you must manually install the plugin.
+For the {product} Adoption Insights plugin, you must manually disable the plugin.
 
 .Procedure
 
-To enable the Adoption Insights plugin, complete the following steps:
+To disable the Adoption Insights plugin, complete the following steps:
 
-. Add the following configuration in your `app-config-dynamic.yaml` file as shown in the following example:
+. Update the following configuration in your `app-config-dynamic.yaml` file as shown in the following example:
 +
 [source,yaml]
 ----