From d8840911d817224beeaf3a91ca8a81f813c6daa6 Mon Sep 17 00:00:00 2001
From: garrytan <garrytan@gmail.com>
Date: Mon, 26 Oct 2026 01:30:18 +0000
Subject: [PATCH] docs(triage): removing the parked label is a manual step
 after a merge closes the issue; close labels are added separately

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
---
 docs/triage.md | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/docs/triage.md b/docs/triage.md
index c32ade091..57bee8764 100644
--- a/docs/triage.md
+++ b/docs/triage.md
@@ -30,11 +30,13 @@ folding it into a tracking issue, or deciding it waits for other work are all
    when it is picked up.
 
 When the work ships, close the issue as fixed with the version or PR. Whatever
-the close reason, remove the `parked` label when the issue closes, so a
-`label:parked` search lists only open parked issues. When a lane picks a parked
-issue up, it removes the label while it works on it (the issue is open again,
-with the lane on it); an issue the lane later drops goes back to parked with an
-updated comment.
+the close reason, remove the `parked` label when the issue closes
+(`gh issue edit <n> --remove-label parked`), so a `label:parked` search lists
+only open parked issues. GitHub leaves labels alone when a merged PR's
+`Closes #<n>` closes the issue, so the lane that ships the fix removes the label
+itself. When a lane picks a parked issue up, it removes the label while it works
+on it (the issue is open again, with the lane on it); an issue the lane later
+drops goes back to parked with an updated comment.
 
 ## Closing an issue
 
@@ -47,6 +49,9 @@ the labels match:
 | **Duplicate** | the issue that tracks it (and that issue is open or parked; if it was already fixed, close this one as fixed too, with the same version) | duplicate (`gh issue close <n> --duplicate-of <m>`) | `duplicate` |
 | **Won't fix** | why: out of scope, a different design was chosen, the premise no longer holds | not planned | `wontfix` |
 
+`gh issue close` sets only the close reason; add the `duplicate` or `wontfix`
+label separately with `gh issue edit <n> --add-label <label>`.
+
 A duplicate of a parked issue is still a duplicate: close it with the link,
 and the parked issue's comment or TODOS.md entry credits both reporters. A
 report that no longer reproduces on current main closes as fixed when a commit,