RHIDP-12636 - Adoption Insights - Display entity titles instead of names in info cards

modules/observability_adoption-insights-in-rhdh/proc-view-the-adoption-insights-card.adoc

@@ -5,6 +5,15 @@
 [role="_abstract"]
 View detailed analytics through individual dashboard cards including active users, total users, and top catalog entities.
 
+[NOTE]
+====
+For the top catalog entities, templates, and techdocs dashboard cards:
+
+* The *Name* column displays `metadata.title` if it exists. If the `metadata.title` is missing or empty, the UI falls back to the `metadata.name`.
+* Hover over the titles to display a tooltip with `entityRef | type | description`.
+* To avoid breaking the layout, long titles are truncated with an ellipsis.
+====
+
 .Procedure
 
 * Navigate to *Administration -> Adoption Insights* to access the dashboard cards.