docs: a reply does not resolve a review thread
Copilot review round 1 on #2273: the text said only a reply in the thread "can resolve it", which is wrong — resolution is a separate act (the Resolve conversation button, or the resolveReviewThread GraphQL mutation) and it is the reviewer's to make. Reading it as satisfied by the documented REST reply is exactly the wrong conclusion for a PR whose whole point is what a reply does. State what the reply actually buys: it is the only thing a reviewer reading that thread sees, and it is what makes resolving the thread defensible. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017nLLLTGc37hQiC8s3mNyhq Signed-off-by: cliffhall <cliff@futurescale.com>
This commit is contained in:
parent
f504b89b56
commit
5a1b5900cf
1 changed files with 6 additions and 3 deletions
|
|
@ -372,7 +372,7 @@ When asked to respond to a code review of a PR:
|
|||
- it is not necessary to implement all suggestions
|
||||
- you are free to implement suggestions in a different way, or to ignore one if there is a good reason
|
||||
- after making the changes, respond to each review comment with what was done (or why it was ignored)
|
||||
- **that response goes in the review comment's own thread — a rollup comment does not discharge it.** Each review comment is a discussion thread with its own resolve state, so a bullet posted elsewhere on the page cannot be connected back to the thread it answers: the thread stays open showing a finding and no reply, and the PR reads as though the review were ignored. Reply inline first, per comment; then post the PR-level summary **in addition**, because inline replies go hidden once the fix is pushed. A finding in the review's "Suppressed comments" block has no thread to reply into, so the summary is the only place it can be answered — that is the one exception. The `gh` calls are in the `pr-flow` skill, step 8.
|
||||
- **that response goes in the review comment's own thread — a rollup comment does not discharge it.** Each review comment is a discussion thread with its own resolve state, so a bullet posted elsewhere on the page cannot be connected back to the thread it answers: the thread stays open showing a finding and no reply, and the PR reads as though the review were ignored. Replying does not itself **resolve** a thread — that is a separate act and the reviewer's to make — but it is what makes resolving it defensible. Reply inline first, per comment; then post the PR-level summary **in addition**, because inline replies go hidden once the fix is pushed. A finding in the review's "Suppressed comments" block has no thread to reply into, so the summary is the only place it can be answered — that is the one exception. The `gh` calls are in the `pr-flow` skill, step 8.
|
||||
|
||||
## Always test new or modified code
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue