From 7298548f826d636bed284af85af6afb081cfb573 Mon Sep 17 00:00:00 2001
From: mrT23 <tal.r@codium.ai>
Date: Wed, 17 Jan 2024 10:06:27 +0200
Subject: [PATCH] improve usage guide

---
 docs/IMPROVE.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/docs/IMPROVE.md b/docs/IMPROVE.md
index bd94f52d..2d0f8751 100644
--- a/docs/IMPROVE.md
+++ b/docs/IMPROVE.md
@@ -16,16 +16,18 @@ The tool can be triggered automatically every time a new PR is [opened](https://
 /improve
 ```
 
-The suggestions can appear as a collapsible comment (pr_code_suggestions.summarize=true):
+### Summarized vs commitable code suggestions
+
+The code suggestions can appear as a single comment (`pr_code_suggestions.summarize=true`):
 <kbd><img src=https://codium.ai/images/pr_agent/code_suggestions_as_comment.png width="768"></kbd>
 
-Or as a separate commitable comment for each suggestion:
+Or as a separate commitable code comment for each suggestion:
 
 
 <kbd><img src=https://codium.ai/images/pr_agent/improve.png width="768"></kbd>
 
 ---
-Note that  a collapsible comment has a significantly smaller PR footprint.
+Note that  a single comment has a significantly smaller PR footprint. We recommend this mode for most cases.
 
 ### Extended mode