docs(pr): 併入上游的流程確認說明並接到重排後的步驟

把上游剛進來的三處確認說明接到重排後的正確步驟,並依準則改寫成英文。
This commit is contained in:
2026-08-31 11:20:27 +08:00
+3 -3
View File
@@ -41,7 +41,7 @@ The ladder rules live in one place only: section 「PR 分支階梯」 of `jsc-m
- Exit 4 (API call failed) → stop and report the failure. Never read a failed call as "no open PR": that opens a second PR on a branch that already has one. - Exit 4 (API call failed) → stop and report the failure. Never read a failed call as "no open PR": that opens a second PR on a branch that already has one.
- Any other non-zero → treat it as exit 4 and stop. - Any other non-zero → treat it as exit 4 and stop.
- Done when either the PR number plus its title, base and body are held, or exit 3 confirmed the branch has no open PR. - Done when either the PR number plus its title, base and body are held, or exit 3 confirmed the branch has no open PR.
7. Create the PR, then hang its prerequisite on it. Run `jsc-gitea/tools/gitea.sh pr-create {owner}/{repo} {target branch} {base branch} "{branch name}" {description file}`. 7. Create the PR, then hang its prerequisite on it. Run `jsc-gitea/tools/gitea.sh pr-create {owner}/{repo} {target branch} {base branch} "{branch name}" {description file}`. Ask the user to confirm before this call runs.
- Title = branch name. - Title = branch name.
- Write the description into a temp file first, using `templates/pr-description.md` (a Traditional Chinese template; the generated description stays in Traditional Chinese per the STE100 output rule). - Write the description into a temp file first, using `templates/pr-description.md` (a Traditional Chinese template; the generated description stays in Traditional Chinese per the STE100 output rule).
- Exit 0 → the command prints a PR URL; keep it. - Exit 0 → the command prints a PR URL; keep it.
@@ -63,8 +63,8 @@ The ladder rules live in one place only: section 「PR 分支階梯」 of `jsc-m
1. Title against the target branch name. 1. Title against the target branch name.
2. Description against a freshly drafted description from `templates/pr-description.md`. 2. Description against a freshly drafted description from `templates/pr-description.md`.
3. Prerequisite PR dependency against the one the description names. 3. Prerequisite PR dependency against the one the description names.
- Title or description differs → write the new description to a temp file and run `jsc-gitea/tools/gitea.sh pr-edit {owner}/{repo} {pr number} "{title}" {description file}`, which carries both items in one call. Exit 0 → updated. Exit 2 (description file not found) → write the file and rerun. Exit 4 or any other non-zero → report the script's message and stop, and say plainly that the PR still holds its old title and description. - Title or description differs → write the new description to a temp file and run `jsc-gitea/tools/gitea.sh pr-edit {owner}/{repo} {pr number} "{title}" {description file}`, which carries both items in one call. Ask the user to confirm before this call runs. Exit 0 → updated. Exit 2 (description file not found) → write the file and rerun. Exit 4 or any other non-zero → report the script's message and stop, and say plainly that the PR still holds its old title and description.
- The dependency differs → run `pr-depend` with the exit code branching of step 7. - The dependency differs → run `pr-depend` with the exit code branching of step 7. Ask the user to confirm before this call runs.
- All three match → change nothing. Every needless edit notifies every reviewer, so silence is the correct outcome here. - All three match → change nothing. Every needless edit notifies every reviewer, so silence is the correct outcome here.
- Done when each of the three items is reported as either matched or updated, and the number of API calls made equals the number of items that differed. - Done when each of the three items is reported as either matched or updated, and the number of API calls made equals the number of items that differed.
9. Reply to the handled comments, then report the run. 9. Reply to the handled comments, then report the run.