docs: update improve.md with folding suggestions feature and add conf…

[mrT23]

User description

…ig option

---

PR Type

Enhancement, Documentation

---

Description

• Added a new feature to fold code suggestions after self-review
• Updated improve.md documentation with details about the folding suggestions feature
• Introduced fold_suggestions_on_self_review configuration option in configuration.toml
• Explained benefits of folding suggestions: reduced visual footprint and indication of author review
• Minor text improvements in existing documentation

---

Changes walkthrough 📝

	Relevant files
Documentation	improve.md Add folding suggestions feature documentation                        docs/docs/tools/improve.md Added a new tip section about reducing visual footprint after self-review Introduced the fold_suggestions_on_self_review configuration parameter Explained the benefits of folding suggestions after self-review Minor capitalization change in an existing tip title +8/-1
Configuration changes	configuration.toml Add fold suggestions configuration option                                pr_agent/settings/configuration.toml Added new configuration option fold_suggestions_on_self_review Set default value to true for the new option Marked the new option as a Pro feature +1/-0

---

💡 PR-Agent usage: Comment /help "your question" on any pull request to receive relevant information

[codiumai-pr-agent-pro]

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 2 🔵🔵⚪⚪⚪

🏅 Score: 95

🧪 No relevant tests

🔒 No security concerns identified

🔀 Multiple PR themes Sub-PR theme: Update improve.md with folding suggestions feature Relevant files: docs/docs/tools/improve.md Sub-PR theme: Add fold_suggestions_on_self_review configuration option Relevant files: pr_agent/settings/configuration.toml

⚡ Recommended focus areas for review Formatting Consistency Ensure consistent capitalization in tip titles. The new tip title uses sentence case, while the existing one uses title case.

[codiumai-pr-agent-pro]

PR Code Suggestions ✨

Explore these optional code suggestions:

Category	Suggestion	Score
Enhancement	Provide a configuration example for the new folding feature to improve user understanding and implementation Consider adding a brief explanation or example of how to set the fold_suggestions_on_self_review parameter in the configuration file. This will provide users with a clear understanding of how to implement this feature. docs/docs/tools/improve.md [119-120] The configuration parameter `pr_code_suggestions.fold_suggestions_on_self_review` (default is True) can be used to automatically fold the suggestions after the user clicks the self-review checkbox. +To enable this feature, add the following line to your configuration file: +```toml +fold_suggestions_on_self_review = true +``` Apply this suggestion Suggestion importance[1-10]: 7 Why: The suggestion adds valuable information by providing a concrete example of how to implement the new feature. This enhances user understanding and ease of adoption, which is particularly important for new functionality.	7
Best practice	Add explanatory comments to new configuration options to improve clarity and maintainability Consider adding a brief comment explaining that this is a new feature, its purpose, and potentially linking to the documentation for more information. pr_agent/settings/configuration.toml [139] +# New feature: Automatically fold code suggestions after self-review +# This reduces visual clutter and indicates that suggestions have been reviewed +# For more information, see: <link_to_documentation> fold_suggestions_on_self_review=true # Pro feature. if true, the code suggestions will be folded after the author clicks on the self-review checkbox Apply this suggestion Suggestion importance[1-10]: 6 Why: The suggestion improves code documentation by adding context and purpose to the new configuration option. This enhances maintainability and user understanding, although the impact is moderate as some explanation already exists in the original comment.	6

💡 Need additional feedback ? start a PR chat