From c23fc6c5297cf228d12bf340e0e0e0e4d9d6bdf9 Mon Sep 17 00:00:00 2001 From: Teal Larson Date: Wed, 9 Sep 2026 13:19:01 -0400 Subject: [PATCH] docs: propose auto-approve conditions for docs PRs Records the risk tiers we want to sort docs PRs into, ahead of building the workflow that enforces them. Sits under .github/auto-approve/ so the policy lands next to the mechanism once that mechanism exists. Co-Authored-By: Claude Opus 5 (1M context) --- .github/auto-approve/README.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 .github/auto-approve/README.md diff --git a/.github/auto-approve/README.md b/.github/auto-approve/README.md new file mode 100644 index 000000000..c31fc3ba8 --- /dev/null +++ b/.github/auto-approve/README.md @@ -0,0 +1,31 @@ +# Auto-approvable changes in ArcadeAI/docs + +## Why auto approve + +Docs are a low-risk surface area. The main priority of our documentation is to +help our users and their agents understand how to operate Arcade in the way that +meets their needs. + +## Proposed auto approve conditions + +### Low risk (auto-approvable) + +- Human-authored PRs under 300 lines with no new routes + +### Medium risk (human review: any team member) + +- Bot-authored PRs +- Human-authored PRs introducing a new page or over 300 lines + +### Higher risk (human review: codeowner) + +- Modifications to the toolkit gen pipeline +- Modifications to GitHub Actions +- Modifications to `package.json` + +## As in other repositories + +- Merging remains a human action +- Approving a PR means you co-sign its contents +- If you aren't sure your change is accurate, tag a subject-matter expert for + review!