Rebased branch and modularized content

Author: pabel-rh

assemblies/assembly-adoption-insights.adoc

@@ -34,9 +34,29 @@ include::modules/observe/adoption-insights/proc-setting-duration-of-data-metrics
 //viewing cards
 include::modules/observe/adoption-insights/proc-viewing-adoption-insights-card.adoc[leveloffset=+1]
 
+include::modules/observe/adoption-insights/proc-viewing-active-users.adoc[leveloffset=+2]
+
+include::modules/observe/adoption-insights/proc-viewing-total-number-of-users.adoc[leveloffset=+2]
+
+include::modules/observe/adoption-insights/proc-viewing-top-catalog-entities.adoc[leveloffset=+2]
+
+include::modules/observe/adoption-insights/proc-viewing-top-templates.adoc[leveloffset=+2]
+
+include::modules/observe/adoption-insights/proc-viewing-top-techdocs.adoc[leveloffset=+2]
+
+include::modules/observe/adoption-insights/proc-viewing-top-plugins.adoc[leveloffset=+2]
+
 //modify number of displayed records
 include::modules/observe/adoption-insights/proc-modify-number-of-displayed-records.adoc[leveloffset=+1]
 
+include::modules/observe/adoption-insights/proc-modify-number-of-displayed-records-in-top-catalog-entities.adoc[leveloffset=+2]
+
+include::modules/observe/adoption-insights/proc-modify-number-of-displayed-records-in-top-templates.adoc[leveloffset=+2]
+
+include::modules/observe/adoption-insights/proc-modify-number-of-displayed-records-in-top-techdocs.adoc[leveloffset=+2]
+
+include::modules/observe/adoption-insights/proc-modify-number-of-displayed-records-in-top-plugins.adoc[leveloffset=+2]
+
 //filter records
 include::modules/observe/adoption-insights/proc-filter-records-to-display-spec.adoc[leveloffset=+1]
 

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

@@ -19,7 +19,7 @@ To disable the Adoption Insights plugin, complete the following steps:
   - package: ./dynamic-plugins/dist/backstage-community-plugin-analytics-provider-segment
     disabled: true
   - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-adoption-insights:bs_1.35.1__0.0.3!red-hat-developer-hub-backstage-plugin-adoption-insights
-    disabled: false
+    disabled: true
     pluginConfig:
       dynamicPlugins:
         frontend:
@@ -38,7 +38,7 @@ To disable the Adoption Insights plugin, complete the following steps:
                 parent: admin
                 icon: adoptionInsightsIcon
   - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-adoption-insights-backend:bs_1.35.1__0.0.4!red-hat-developer-hub-backstage-plugin-adoption-insights-backend
-    disabled: false
+    disabled: true
   - package: oci://ghcr.io/redhat-developer/rhdh-plugin-export-overlays/red-hat-developer-hub-backstage-plugin-analytics-module-adoption-insights:bs_1.35.1__0.0.2!red-hat-developer-hub-backstage-plugin-analytics-module-adoption-insights
     disabled: false
     pluginConfig:

modules/observe/adoption-insights/proc-modify-number-of-displayed-records-in-top-catalog-entities.adoc

@@ -0,0 +1,18 @@
+:_mod-docs-content-type: PROCEDURE
+[id="proc-modify-number-of-displayed-records-in-top-catalog-entities_{context}"]
+= Modifying the number of displayed records in Top catalog entities
+
+You can modify the number of records that are displayed in the *Top catalog entities* card. You can select any of the following number of records for display:
+
+* *Top 3*
+* *Top 5*
+* *Top 10*
+* *Top 20*
+
+By default, the top three most viewed catalog entities are displayed. 
+
+.Procedure
+
+* Go to *Administration -> Adoption Insights* and click the *Down* arrow next to *3 rows* to change the number of displayed records.
+
+image::rhdh-plugins-reference/adoption-insights-catalog-entities.jpg[Catalog Entities dropdown]

modules/observe/adoption-insights/proc-modify-number-of-displayed-records-in-top-plugins.adoc

@@ -0,0 +1,16 @@
+:_mod-docs-content-type: PROCEDURE
+[id="proc-modify-number-of-displayed-records-in-top-plugins_{context}"]
+= Modifying the number of displayed records in Top 3 plugins
+
+You can modify the number of records that are displayed in the *Top 3 plugins* card. You can select any of the following number of records for display:
+
+* *Top 3*
+* *Top 5*
+* *Top 10*
+* *Top 20*
+
+By default, the top three most viewed plugins are displayed. 
+
+.Procedure
+
+* Go to *Administration -> Adoption Insights* and click the *Down* arrow next to *3 rows* to change the number of displayed records.

modules/observe/adoption-insights/proc-modify-number-of-displayed-records-in-top-techdocs.adoc

@@ -0,0 +1,16 @@
+:_mod-docs-content-type: PROCEDURE
+[id="proc-modify-number-of-displayed-records-in-top-techdocs_{context}"]
+= Modifying the number of displayed records in Top 3 techdocs
+
+You can modify the number of records that are displayed in the *Top 3 techdocs* card. You can select any of the following number of records for display:
+
+* *Top 3*
+* *Top 5*
+* *Top 10*
+* *Top 20*
+
+By default, the top three most viewed TechDocs are displayed. 
+
+.Procedure
+
+* Go to *Administration -> Adoption Insights* and click the *Down* arrow next to *3 rows* to change the number of displayed records.

modules/observe/adoption-insights/proc-modify-number-of-displayed-records-in-top-templates.adoc

@@ -0,0 +1,16 @@
+:_mod-docs-content-type: PROCEDURE
+[id="proc-modify-number-of-displayed-records-in-top-templates_{context}"]
+= Modifying the number of displayed records in Top 3 templates
+
+You can modify the number of records that are displayed in the *Top 3 templates* card. You can select any of the following number of records for display:
+
+* *Top 3*
+* *Top 5*
+* *Top 10*
+* *Top 20*
+
+By default, the top three most viewed templates are displayed. 
+
+.Procedure
+
+* Go to *Administration -> Adoption Insights* and click the *Down* arrow next to *3 rows* to change the number of displayed records.

modules/observe/adoption-insights/proc-modify-number-of-displayed-records.adoc

@@ -2,6 +2,8 @@
 [id="proc-modify-number-of-displayed-records_{context}"]
 = Modifying the number of displayed records
 
+You can modify the number of displayed records in Adoption Insights for the following cards.
+
 == Modifying the number of displayed records in Top catalog entities
 
 You can modify the number of records that are displayed in the *Top catalog entities* card. You can select any of the following number of records for display:

modules/observe/adoption-insights/proc-viewing-active-users.adoc

@@ -0,0 +1,19 @@
+:_mod-docs-content-type: PROCEDURE
+[id="proc-viewing-active-users_{context}"]
+= Viewing the active users
+
+The *Active users* card displays the total number of active users over a specified time range. It also provides a breakdown comparison of *New users* and *Returning users* in a line/area graph format. You can export the user data in a .csv format.
+
+* *Returning users*: Existing users who have logged into {product-short}
+
+* *New users*: New users who have registered and logged into {product-short}
+
+image::rhdh-plugins-reference/active-users.jpg[active users]
+
+.Procedure
+
+* To view the list of active users in your Developer Hub instance, go to *Administration -> Adoption Insights*, see the *Active users* card. 
+
+* To view the exact number of users for a particular day, hover over the corresponding date in the *Active users* card.
+
+* To export the user data in a .csv format, click the *Export CSV* label.

modules/observe/adoption-insights/proc-viewing-adoption-insights-card.adoc

@@ -1,95 +1,3 @@
 :_mod-docs-content-type: PROCEDURE
 [id="proc-viewing-adoption-insights-card_{context}"]
 = Viewing the Adoption Insights card
-
-== Viewing the active users
-
-The *Active users* card displays the total number of active users over a specified time range. It also provides a breakdown comparison of *New users* and *Returning users* in a line/area graph format. You can export the user data in a .csv format.
-
-* *Returning users*: Existing users who have logged into {product-short}
-
-* *New users*: New users who have registered and logged into {product-short}
-
-image::rhdh-plugins-reference/active-users.jpg[active users]
-
-.Procedure
-
-* To view the list of active users in your Developer Hub instance, go to *Administration -> Adoption Insights*, see the *Active users* card. 
-
-* To view the exact number of users for a particular day, hover over the corresponding date in the *Active users* card.
-
-* To export the user data in a .csv format, click the *Export CSV* label.
-
-== Viewing the total number of users
-
-This card displays the total number of users that have license to use {product}. It also provides a comparison of the number of *Logged-in users* and *Licensed users* in numeric and percentage form. 
-
-* *Logged-in users*: Total number of users, including licensed and unlicensed users, currently logged in to {product-short}.
-
-* *Licensed users*: Total number of licensed users logged in to {product-short}. You can set the number of licensed users in your {product-short} app-config.yaml file.
-
-.Procedure
-
-* To view the total number of users in your {product-short} instance in numeric and percentage forms, go to *Administration -> Adoption Insights* and see the *Total number of users* card.
-
-* To view a percentage representation of the total number of logged-in users among the total number of licensed users, hover over the tooltip in the *Total number of users* card.
-
-== Viewing the top catalog entities
-
-This card lists the most viewed catalog entities (like components, APIs, and so on) and documentation entries, including usage statistics, in a table. 
-
-Each item displays the following details:
-
-* *Name*: Name of the catalog
-* *Kind*: Type of the catalog
-* *Last used*: The last time the catalog was used
-* *Views*: The number of times the catalog was viewed
-
-.Procedure
-
-* To view the most commonly used catalog entities in your {product-short} instance, go to *Administration -> Adoption Insights* and see the *Top catalog entities* card. 
-
-* To know more about the displayed catalog entity, hover over the catalog entity name.
-
-== Viewing the top 3 templates
-
-This card lists the three most commonly used templates in a table. You can click the down arrow next to *3 rows* to view the full list of the commonly used templates.
-
-* *Name*: Name of the template
-* *Mostly in use by*: Type of user using this template most frequently
-* *Executions*: Number of times this template was used
-
-.Procedure
-
-* To view the most commonly used templates in your {product-short} instance, go to *Administration -> Adoption Insights* and see the *Top 3 templates* card. 
-
-* To know more about the displayed template, hover over the template name.
-
-== Viewing the top 3 techdocs
-
-This card lists the most viewed documentation entries, including the total views, in a table.
-
-* *Name*: Name of the documentation
-* *Entity*: Type of the documentation
-* *Last used*: The last time the documentation was viewed
-* *Views*: Number of times the documentation was visited
-
-.Procedure
-
-* To view the most commonly used templates in your {product-short} instance, go to *Administration -> Adoption Insights* and see the *Top 3 techdocs* card. 
-
-* To know more about the displayed techdocs, hover over the techdocs name.
-
-== Viewing the top 3 plugins
-
-This card lists the three most commonly used plugins in a table. You can click the down arrow next to *3 rows* to view the full list of the commonly used plugins. 
-
-* *Name*: Name of the plugin
-* *Trend*: Popularity of the plugin as a graph
-* *Views*: Number of times this plugin was seen
-
-.Procedure
-
-* To view the most commonly used plugins and the plugin page visit trends in your {product-short} instance, go to *Administration -> Adoption Insights* and see the *Top 3 plugins* card. 
-
-* To know more about the displayed plugin, hover over the plugin name.

modules/observe/adoption-insights/proc-viewing-top-catalog-entities.adoc

@@ -0,0 +1,18 @@
+:_mod-docs-content-type: PROCEDURE
+[id="proc-top-catalog-entities_{context}"]
+= Viewing the top catalog entities
+
+This card lists the most viewed catalog entities (like components, APIs, and so on) and documentation entries, including usage statistics, in a table. 
+
+Each item displays the following details:
+
+* *Name*: Name of the catalog
+* *Kind*: Type of the catalog
+* *Last used*: The last time the catalog was used
+* *Views*: The number of times the catalog was viewed
+
+.Procedure
+
+* To view the most commonly used catalog entities in your {product-short} instance, go to *Administration -> Adoption Insights* and see the *Top catalog entities* card. 
+
+* To know more about the displayed catalog entity, hover over the catalog entity name.