From d24ad4f55d68cd5e4d2373e7befa51e603817120 Mon Sep 17 00:00:00 2001 From: morluto <76467478+morluto@users.noreply.github.com> Date: Sun, 25 Oct 2026 05:19:22 +0800 Subject: [PATCH] docs: make pull request draft status optional --- AGENTS.md | 9 +++++---- CONTRIBUTING.md | 6 +++++- 2 files changed, 10 insertions(+), 5 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 3052b0222a..b542f3cfa2 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -108,10 +108,11 @@ distinguish source-derived conclusions, proposed checks, and unavailable coverag Address actionable automated review findings and explain disagreements. Leave the template's **Author readiness** declarations unchecked for the human -owner to complete. Never attest to human review on their behalf. Keep the PR in -draft until the human declares the PR initially ready. Later pushes do not -invalidate that declaration or require another human sign-off. Keep the PR body -and affected validation current as work changes. The readiness check validates +owner to complete. Never attest to human review on their behalf. Draft status +is optional; preserve the PR's current draft status unless the user asks to change +it. Later pushes do not invalidate the readiness declaration or require another +human sign-off. Keep the PR body and affected validation current as work changes. +The readiness check validates the filled declaration; CI and automated review results do not establish that human review occurred, maintainer scope approval, or merge permission. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 19f87f919b..e3ff9f31f4 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -89,7 +89,11 @@ Human ownership and review remain required when CI or an automated reviewer reports success. Readiness requests maintainer review; it does not grant scope approval or permission to merge. -Draft PRs may request early feedback with open questions and incomplete checks. +Draft status is optional. Draft PRs may request early feedback with open questions +and incomplete checks. Agents preserve the current draft status unless asked to +change it; missing readiness declarations or later updates do not require a PR +to become a draft. + Leave the readiness declaration unchecked until the human owner has completed it. The declaration records initial readiness; later pushes do not invalidate it or require another human sign-off. Keep the PR description and affected