Improve Patcher documentation: clarify use cases and add simplified GitHub Actions guide

[devin-ai-integration]

Improve Patcher documentation: clarify use cases and add simplified GitHub Actions guide

Summary

This PR addresses the confusion around Patcher's two primary use cases by creating clearer documentation paths:

1. New guide: "GitHub Actions for Continuous Updates" - A simplified workflow that scans the entire repository and creates PRs for all outdated dependencies. Ideal for teams who want to keep their codebase current without environment-specific promotion.

2. Updated existing guide: Enhanced "Setting up Promotion Workflows" to clearly explain it's for teams needing dev → stage → prod promotion with environment-specific validation.

Key changes:

• Created /docs/2.0/docs/patcher/guides/github-actions-continuous-updates.md (171 lines) with a simplified GitHub Actions workflow
• Updated promotion workflows guide to clarify when to use each approach
• Added the new guide to sidebar navigation as the first option in Guides section
• Added cross-references between the two guides to help users choose the right approach

The new workflow removes the include_dirs filtering and environment-specific logic from the promotion workflow examples, making it suitable for scanning entire repositories.

Review & Testing Checklist for Human

• Verify docs site builds and renders correctly - Test that the new markdown file renders properly and doesn't break the documentation site
• Validate GitHub Actions YAML syntax - Check that the workflow in the new guide has correct YAML syntax and valid patcher-action parameters
• Test all internal links - Confirm cross-references between the new continuous updates guide and promotion workflows guide work correctly
• Review user experience flow - Ensure the distinction between the two approaches is clear and users can easily choose the right path
• Check sidebar navigation - Verify the new guide appears correctly in the sidebar and doesn't break navigation

Notes

• The new workflow is based on the existing promotion workflow examples but simplified to remove environment-specific scanning
• Cross-references were added in both directions to help users navigate between the two approaches
• The new guide was positioned first in the Guides section since it's the simpler use case

Link to Devin run: https://app.devin.ai/sessions/fc64367622e64e1d8f29fddec6441a64
Requested by: Josh Padnick (@josh-padnick)

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
docs	Ready	Preview	Comment	Aug 30, 2025 1:42am

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

---

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

• Review comments: Directly reply to a review comment made by CodeRabbit. Example:
  • I pushed a fix in commit <commit_id>, please review it.
  • Open a follow-up GitHub issue for this discussion.
• Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
• PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
  • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
  • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Join our Discord community for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

• Add @coderabbitai ignore or @coderabbit ignore anywhere in the PR description to prevent this PR from being reviewed.
• Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
• Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

• You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
• Please see the configuration documentation for more information.
• If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

• Visit our Status Page to check the current availability of CodeRabbit.
• Visit our Documentation for detailed information on how to use CodeRabbit.
• Join our Discord Community to get help, request features, and share feedback.
• Follow us on X/Twitter for updates and announcements.