Update automations_and_usage.md

[mrT23]

PR Type

documentation

---

Description

• Updated the configuration examples in the automations_and_usage.md documentation to reflect changes in command parameters.
• Removed specific parameters from the /review command to simplify examples.
• Added a new section to enable BitBucket app to respond to each push to the PR.
• Corrected minor grammatical errors to improve readability.

---

Changes walkthrough 📝

	Relevant files
Documentation	automations_and_usage.md Update configuration examples and improve clarity in automation guide docs/docs/usage-guide/automations_and_usage.md Updated configuration examples for pr_commands and push_commands. Removed specific parameters from /review command. Added new configuration for BitBucket push handling. Corrected minor grammatical errors. +21/-11

---

💡 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: 1 🔵⚪⚪⚪⚪

🏅 Score: 95

🧪 No relevant tests

🔒 No security concerns identified

⚡ Recommended focus areas for review Documentation Clarity Ensure that the new configuration examples are clear and consistent across different sections (GitHub, GitLab, BitBucket).

[codiumai-pr-agent-pro]

PR Code Suggestions ✨

Explore these optional code suggestions:

Category	Suggestion	Score
Enhancement	Clarify the reasoning behind the higher suggestions score threshold for BitBucket Consider adding a brief explanation of why the recommended suggestions_score_threshold for BitBucket is higher (7) compared to the general example (5). This will help users understand the reasoning behind the different thresholds for different platforms. docs/docs/usage-guide/automations_and_usage.md [201-202] -Note that we set specifically for bitbucket, we recommend using: `--pr_code_suggestions.suggestions_score_threshold=7` and that is the default value we set for bitbucket. -Since this platform only supports inline code suggestions, we want to limit the number of suggestions, and only present a limited number. +Note that specifically for BitBucket, we recommend using: `--pr_code_suggestions.suggestions_score_threshold=7`, which is also the default value we set for this platform. We use a higher threshold compared to other platforms because BitBucket only supports inline code suggestions. This higher threshold helps limit the number of suggestions, ensuring only the most relevant and high-quality improvements are presented. Apply this suggestion Suggestion importance[1-10]: 8 Why: This suggestion provides important context for the different threshold values across platforms, helping users understand the rationale behind the BitBucket-specific configuration.	8
	Provide a more detailed explanation of the suggestions_score_threshold parameter's purpose and effect Consider adding a brief explanation of what the suggestions_score_threshold parameter means and how it affects the improve tool's behavior. This will help users understand the significance of setting this parameter. docs/docs/usage-guide/automations_and_usage.md [81] -For the `improve` tool, for example, the `suggestions_score_threshold` parameter will be set to 5 (suggestions below a score of 5 won't be presented) +For the `improve` tool, for example, the `suggestions_score_threshold` parameter will be set to 5. This means that only suggestions with a score of 5 or higher will be presented, filtering out lower-quality or less relevant suggestions. Apply this suggestion Suggestion importance[1-10]: 7 Why: The suggestion adds valuable context to help users understand the purpose and impact of the suggestions_score_threshold parameter, which is important for effective use of the improve tool.	7
Typo	Correct grammar and improve clarity in the sentence about PAT token characteristics Consider rephrasing the sentence about PAT token expiration to improve clarity and grammar. docs/docs/usage-guide/automations_and_usage.md [223] -PAT is faster to create, but has a build in expiration date, and will use the user identity for API calls. +PAT is faster to create, but it has a built-in expiration date and will use the user's identity for API calls. Apply this suggestion Suggestion importance[1-10]: 6 Why: The suggestion corrects a minor grammatical error ("build" to "built") and slightly improves the sentence structure, enhancing readability and professionalism of the documentation.	6

• Author self-review: I have reviewed the PR code suggestions, and addressed the relevant ones.

💡 Need additional feedback ? start a PR chat