ti.sil/pr-agent
1
0
Fork 0
mirror of https://github.com/qodo-ai/pr-agent.git synced 2025-12-11 18:35:18 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs: enhance explanation of table vs committable code comments in Qodo Merge

Browse source
This commit is contained in:
mrT23 2025-09-10 07:45:42 +03:00
parent 3fd8210279
commit fc1b757e92
No known key found for this signature in database
GPG key ID: D350490E39D5F5AD
1 changed files with 20 additions and 19 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

39
docs/docs/tools/improve.md
View file

@ -24,25 +24,6 @@ ___
## Example usage
### Table vs Committable code comments
Qodo Merge supports two modes for presenting code suggestions:
1) [Table](https://codium.ai/images/pr_agent/code_suggestions_as_comment_closed.png) mode
2) [Committable](https://codium.ai/images/pr_agent/improve.png) code comments mode.
Both modes are useful and depend on your preferences and workflow. We recommend using table mode, since it provides the following advantages:
- The table format creates significantly less noise in the PR
- It enables quick review of one-liner summaries, severity levels, and easy prioritization of important suggestions
- High-level suggestions that aren't tied to specific code chunks are presented only in the table mode
- The table provides 'more' and 'update' functionality through clickable buttons
- The table makes it easy to track in a single place which suggestions have already been applied
- Suggestion from the table can be applied in your IDE environment via [Qodo Command](https://github.com/qodo-ai/agents)
### Manual triggering
Invoke the tool manually by commenting `/improve` on any PR. The code suggestions by default are presented as a single comment:
@ -88,6 +69,26 @@ num_code_suggestions_per_chunk = ...
- The `pr_commands` lists commands that will be executed automatically when a PR is opened.
- The `[pr_code_suggestions]` section contains the configurations for the `improve` tool you want to edit (if any)
### Table vs Committable code comments
Qodo Merge supports two modes for presenting code suggestions:
1) [Table](https://codium.ai/images/pr_agent/code_suggestions_as_comment_closed.png) mode
2) [Inline Committable](https://codium.ai/images/pr_agent/improve.png) code comments mode.
The table format offers several key advantages:
- **Reduced noise**: Creates a cleaner PR experience with less clutter
- **Quick overview and prioritization**: Enables quick review of one-liner summaries, severity levels, and easy prioritization
- **High-level suggestions**: High-level suggestions that aren't tied to specific code chunks are presented only in the table mode
- **Interactive features**: Provides 'more' and 'update' functionality via clickable buttons
- **Centralized tracking**: Shows suggestion implementation status in one place
- **IDE integration**: Allows direct application in your IDE via [Qodo Command](https://github.com/qodo-ai/agents)
Table mode is the default of Qodo Merge, and is recommended approach for most users due to these benefits.
Teams with specific preferences can enable committable code comments mode in their local configuration, or use [dual publishing mode](#dual-publishing-mode).
### Assessing Impact
>`💎 feature`