diff --git a/docs/tool-catalog.md b/docs/tool-catalog.md
index 1a6425b36d..5b9bebeaf7 100644
--- a/docs/tool-catalog.md
+++ b/docs/tool-catalog.md
@@ -52,7 +52,7 @@ Ask the user a concise question when you need confirmation, a choice, or missing
           },
           "options": {
             "type": "array",
-            "description": "Optional choices to show the user.",
+            "description": "Optional choices to show the user. If you recommend one, put it first and append \"(Recommended)\" to that label.",
             "items": {
               "type": "object",
               "properties": {