From 862abdeef8d3830c69f9ab40b34521c619c8ab96 Mon Sep 17 00:00:00 2001
From: thsparks <thsparks@microsoft.com>
Date: Thu, 22 Feb 2024 15:42:56 -0800
Subject: [PATCH] Add descriptions

---
 common-docs/teachertool/catalog-shared.json | 31 +++++++++++++--------
 1 file changed, 20 insertions(+), 11 deletions(-)

diff --git a/common-docs/teachertool/catalog-shared.json b/common-docs/teachertool/catalog-shared.json
index cab05f47fcf8..3da7051b682b 100644
--- a/common-docs/teachertool/catalog-shared.json
+++ b/common-docs/teachertool/catalog-shared.json
@@ -4,55 +4,64 @@
             "id": "B3FD8B3D-61B4-42F4-B0EF-64BD7D62CDAB",
             "use": "two_different_loops",
             "template": "Two different kinds of loops used",
-            "docPath": "/teachertool"
+            "docPath": "/teachertool",
+            "description": "Checks that the program uses two different types of loops (for, repeat, while, or for-of)."
         },
         {
             "id": "49262A2B-C02A-43A2-BAD5-FCAC6AE9D464",
             "use": "custom_function_called",
             "template": "A custom function exists and gets called",
-            "docPath": "/teachertool"
+            "docPath": "/teachertool",
+            "description": "Checks that a user-defined function is created and called in the program."
         },
         {
             "id": "76D86387-E3CF-4BEB-B62C-B811F5997631",
             "use": "block_comment_used",
             "template": "At least one block has comments",
-            "docPath": "/teachertool"
+            "docPath": "/teachertool",
+            "description": "Checks that at least one code block has a comment attached to it."
         },
         {
             "id": "8F97C9A6-CF16-48B4-A84F-3105C24B20DE",
             "use": "functions_have_comments",
             "template": "All function definitions have comments",
-            "docPath": "/teachertool"
+            "docPath": "/teachertool",
+            "description": "Checks that all user-defined functions in the program have comments attached to them."
         },
         {
             "id": "D21D76A2-D9FD-4F9B-B0AC-973CB870EA78",
             "use": "variable_set",
             "template": "At least one custom variable is set",
-            "docPath": "/teachertool"
+            "docPath": "/teachertool",
+            "description": "Checks that at least one user-defined variable is set to a value."
         },
         {
             "id": "0173898D-8A48-4266-AAB9-CE934471A734",
             "use": "variable_accessed",
             "template": "At least one variable is accessed",
-            "docPath": "/teachertool"
+            "docPath": "/teachertool",
+            "description": "Checks that at least one variable's value is read."
         },
         {
             "id": "8E6F9A92-2D22-4BB0-A77A-BD7490D3CEF7",
             "use": "variable_set_random",
             "template": "A custom variable's value is set to a random number",
-            "docPath": "/teachertool"
+            "docPath": "/teachertool",
+            "description": "Checks that a user-defined variable has its value set to a random number."
         },
         {
             "id": "E8DAD360-F4AB-4E6B-9981-C14BDEE1295B",
             "use": "device_random_used",
-            "template": "The math random number generator block is used",
-            "docPath": "/teachertool"
+            "template": "The 'pick random' block is used",
+            "docPath": "/teachertool",
+            "description": "Checks that the 'pick random' block from the math category is used at least once."
         },
         {
             "id": "DC564060-F177-46CC-A3AC-890CD8545972",
             "use": "num_compare_eq",
             "template": "Compare two numbers for equality",
-            "docPath": "/teachertool"
+            "docPath": "/teachertool",
+            "description": "Checks that the program compares two numbers for equality at least once."
         }
     ]
-}
\ No newline at end of file
+}