From c4ccfee69480f7e9a702343b9c7715f89c88d594 Mon Sep 17 00:00:00 2001
From: ggurdin <46800240+ggurdin@users.noreply.github.com>
Date: Tue, 23 Sep 2025 11:20:07 -0400
Subject: [PATCH] chore: add descriptions for analytics categories (#4100)

---
 lib/l10n/intl_en.arb                          |  5 ++++-
 .../lemma_usage_dots.dart                     | 21 ++++++++++++++-----
 .../analytics_misc/learning_skills_enum.dart  | 13 ++++++++++++
 3 files changed, 33 insertions(+), 6 deletions(-)

diff --git a/lib/l10n/intl_en.arb b/lib/l10n/intl_en.arb
index d0001808d..44fc3b076 100644
--- a/lib/l10n/intl_en.arb
+++ b/lib/l10n/intl_en.arb
@@ -5252,5 +5252,8 @@
   "courseDesc": "Course description",
   "courseSavedSuccessfully": "Course saved successfully",
   "addCoursePlan": "Add a course plan",
-  "activityStatsButtonInstruction": "Click here to view your activity stats and to close the activity when finished"
+  "activityStatsButtonInstruction": "Click here to view your activity stats and to close the activity when finished",
+  "readingAnalyticsDesc": "Click practice on each message for reading activities.",
+  "speakingAnalyticsDesc": "Record voice messages for speaking practice.",
+  "audioAnalyticsDesc": "Click practice on each message for listening activities."
 }
diff --git a/lib/pangea/analytics_details_popup/lemma_usage_dots.dart b/lib/pangea/analytics_details_popup/lemma_usage_dots.dart
index 15911a298..b54d8d1f6 100644
--- a/lib/pangea/analytics_details_popup/lemma_usage_dots.dart
+++ b/lib/pangea/analytics_details_popup/lemma_usage_dots.dart
@@ -58,6 +58,8 @@ class LemmaUsageDots extends StatelessWidget {
         ? construct.lemmaCategory.color(context)
         : construct.lemmaCategory.darkColor(context));
 
+    final description = category.description(context);
+
     return Padding(
       padding: const EdgeInsets.symmetric(vertical: 20),
       child: Row(
@@ -75,11 +77,20 @@ class LemmaUsageDots extends StatelessWidget {
           ),
           const SizedBox(width: 8.0),
           Flexible(
-            child: Wrap(
-              spacing: 3,
-              runSpacing: 5,
-              children: dots,
-            ),
+            child: dots.isEmpty
+                ? description != null
+                    ? Text(
+                        description,
+                        style: const TextStyle(
+                          fontStyle: FontStyle.italic,
+                        ),
+                      )
+                    : const SizedBox()
+                : Wrap(
+                    spacing: 3,
+                    runSpacing: 5,
+                    children: dots,
+                  ),
           ),
         ],
       ),
diff --git a/lib/pangea/analytics_misc/learning_skills_enum.dart b/lib/pangea/analytics_misc/learning_skills_enum.dart
index 60fad7847..4e68eb98d 100644
--- a/lib/pangea/analytics_misc/learning_skills_enum.dart
+++ b/lib/pangea/analytics_misc/learning_skills_enum.dart
@@ -33,4 +33,17 @@ enum LearningSkillsEnum {
         return "";
     }
   }
+
+  String? description(BuildContext context) {
+    switch (this) {
+      case LearningSkillsEnum.reading:
+        return L10n.of(context).readingAnalyticsDesc;
+      case LearningSkillsEnum.hearing:
+        return L10n.of(context).audioAnalyticsDesc;
+      case LearningSkillsEnum.speaking:
+        return L10n.of(context).speakingAnalyticsDesc;
+      default:
+        return null;
+    }
+  }
 }