Merge pull request #627 from Codium-ai/tr/updates2

Tr/updates2

Usage.md

@@ -142,8 +142,7 @@ num_code_suggestions=1
 Then you will overwrite the default number of code suggestions to 1.
 
 #### GitHub app automatic tools
-The [github_app](pr_agent/settings/configuration.toml#L76) section defines GitHub app-specific configurations.  
-In this section, you can define configurations to control the conditions for which tools will **run automatically**.  
+The [github_app](pr_agent/settings/configuration.toml#L108) section defines GitHub app specific configurations.  
 
 ##### GitHub app automatic tools for PR actions 
 The configuration parameter `pr_commands` defines the list of tools that will be **run automatically** when a new PR is opened.
@@ -222,7 +221,7 @@ Specifically, start by setting the following environment variables:
         github_action_config.auto_improve: "false" # enable\disable auto improve
 ```
 `github_action_config.auto_review`, `github_action_config.auto_describe` and `github_action_config.auto_improve` are used to enable/disable automatic tools that run when a new PR is opened.
-If not set, the default option is that only the `review` tool will run automatically when a new PR is opened.
+If not set, the default configuration is for all three tools to run automatically when a new PR is opened.
 
 Note that you can give additional config parameters by adding environment variables to `.github/workflows/pr_agent.yml`, or by using a `.pr_agent.toml` file in the root of your repo, similar to the GitHub App usage.
 

pr_agent/servers/help.py

@@ -48,7 +48,7 @@ Examples for extra instructions:
 ```
 [pr_reviewer] # /review #
 extra_instructions="""
-In the code feedback section, emphasize the following:
+In the 'general suggestions' section, emphasize the following:
 - Does the code logic cover relevant edge cases?
 - Is the code logic clear and easy to understand?
 - Is the code logic efficient?
@@ -71,14 +71,14 @@ Edit this field to enable/disable the tool, or to change the used configurations
         """
         output += "\n\n</details></td></tr>\n\n"
 
-        # code feedback
-        output += "<tr><td><details> <summary><strong> About the 'Code feedback' section</strong></summary><hr>\n\n"
-        output+="""\
-The `review` tool provides several type of feedbacks, one of them is code suggestions.
-If you are interested **only** in the code suggestions, it is recommended to use the [`improve`](https://github.com/Codium-ai/pr-agent/blob/main/docs/IMPROVE.md) feature instead, since it dedicated only to code suggestions, and usually gives better results.
-Use the `review` tool if you want to get a more comprehensive feedback, which includes code suggestions as well.
-"""
-        output += "\n\n</details></td></tr>\n\n"
+#         # code feedback
+#         output += "<tr><td><details> <summary><strong> About the 'Code feedback' section</strong></summary><hr>\n\n"
+#         output+="""\
+# The `review` tool provides several type of feedbacks, one of them is code suggestions.
+# If you are interested **only** in the code suggestions, it is recommended to use the [`improve`](https://github.com/Codium-ai/pr-agent/blob/main/docs/IMPROVE.md) feature instead, since it dedicated only to code suggestions, and usually gives better results.
+# Use the `review` tool if you want to get a more comprehensive feedback, which includes code suggestions as well.
+# """
+#         output += "\n\n</details></td></tr>\n\n"
 
         # auto-labels
         output += "<tr><td><details> <summary><strong> Auto-labels</strong></summary><hr>\n\n"
@@ -309,8 +309,9 @@ Use triple quotes to write multi-line instructions. Use bullet points to make th
         output += """\
 - While the current AI for code is getting better and better (GPT-4), it's not flawless. Not all the suggestions will be perfect, and a user should not accept all of them automatically.
 - Suggestions are not meant to be simplistic. Instead, they aim to give deep feedback and raise questions, ideas and thoughts to the user, who can then use his judgment, experience, and understanding of the code base.
-- Recommended to use the 'extra_instructions' field to guide the model to suggestions that are more relevant to the specific needs of the project.
-- Best quality will be obtained by using 'improve --extended' mode.
+- Recommended to use the 'extra_instructions' field to guide the model to suggestions that are more relevant to the specific needs of the project, or use the [custom suggestions :gem:](https://github.com/Codium-ai/pr-agent/blob/main/docs/CUSTOM_SUGGESTIONS.md) tool
+- With large PRs, best quality will be obtained by using 'improve --extended' mode.
+
 
 """
         output += "\n\n</details></td></tr>\n\n"\