Commit d775997ead

d775997ead04022093817ab513287b5886065247

parent: b893d66995

Verified · cmc

cmc <hello@cleberg.net> · 2026-09-11 15:49 UTC

wiki: org labels, milestones and cross-repository closes

Ref #203

Layout: unified · split

.gitbay/wiki/Parity.org +8
@@ -113,6 +113,9 @@ reviews, since an approval was of the diff against the old branch.
113| choose body markup | yes | yes | yes | 113| choose body markup | yes | yes | yes |
114| issue templates | yes | yes | yes | 114| issue templates | yes | yes | yes |
115| milestone create, close, reopen | yes | no | yes | 115| milestone create, close, reopen | yes | no | yes |
116| org labels: set, list, remove | yes | list | no |
117| org milestones: create, list, close, reopen | yes | list | no |
118| closes across repositories | yes | yes | yes |
116 119
117Labels are created on the fly by =issue label --add= and managed by 120Labels are created on the fly by =issue label --add= and managed by
118=label list=, =label set <label> --color rrggbb= and =label remove=, 121=label list=, =label set <label> --color rrggbb= and =label remove=,
@@ -121,6 +124,11 @@ on every chip and derives one from the name when none is set. The set
121itself is at =/<owner>/<repo>/labels=, linked from the issue list: 124itself is at =/<owner>/<repo>/labels=, linked from the issue list:
122create, recolour and remove, dispatching the same commands. 125create, recolour and remove, dispatching the same commands.
123 126
127Org labels and milestones are managed on the CLI and API only;
128=/<org>/-/labels= and =/<org>/-/milestones= show them. The repository
129label page's form exists for colour alone, and three org forms nobody
130asked for were not worth their handlers.
131
124Issue, MR and release bodies, and their comments, carry the markup they 132Issue, MR and release bodies, and their comments, carry the markup they
125were written in — =--format md|org= on create, comment and edit, stored 133were written in — =--format md|org= on create, comment and edit, stored
126alongside the text so changing a preference later cannot reinterpret 134alongside the text so changing a preference later cannot reinterpret
.gitbay/wiki/Users.org +21 −1
@@ -347,7 +347,9 @@ pages carry the discovery link.
347Commit messages act on issues when the commits land on the default 347Commit messages act on issues when the commits land on the default
348branch (direct push or MR merge): =closes/fixes/resolves #4= closes the 348branch (direct push or MR merge): =closes/fixes/resolves #4= closes the
349issue with a linking comment, and a bare =#4= leaves a reference 349issue with a linking comment, and a bare =#4= leaves a reference
350comment. Each issue/commit pair acts once, ever. Same repository only. 350comment. Each issue/commit pair acts once, ever. =Closes owner/name#N= closes an issue in another repository when
351you hold write there; otherwise it stays a plain link. A bare
352=owner/name#N= links and does nothing.
351 353
352Milestones group issues and MRs toward a release (write access to 354Milestones group issues and MRs toward a release (write access to
353manage, attach with =issue milestone= / =mr milestone=; progress shows 355manage, attach with =issue milestone= / =mr milestone=; progress shows
@@ -359,6 +361,24 @@ gitbay milestone list [--state open|closed|all]
359gitbay milestone close v1.0 / reopen v1.0 361gitbay milestone close v1.0 / reopen v1.0
360#+end_src 362#+end_src
361 363
364An org holds labels and milestones every repository under it sees
365beside its own. =issue label --add=, =issue milestone= and =mr
366milestone= resolve the org's row first; a repository cannot create a
367label or milestone with a name its org holds. Creating an org label or
368milestone whose name repositories under the org already use folds them
369in: their issues and merge requests move to the org's row. Org admins
370manage them; counts span the repositories you can read.
371
372#+begin_src sh
373gitbay org label set acme bug --color cf222e
374gitbay org label list acme / remove acme bug
375gitbay org milestone create acme v2 --due 2027-03-01
376gitbay org milestone list acme [--state open|closed|all]
377gitbay org milestone close acme v2 / reopen acme v2
378#+end_src
379
380On the web: =/acme/-/labels= and =/acme/-/milestones=, read-only.
381
362Issue templates: commit =.gitbay/issue-template.md= (and optional 382Issue templates: commit =.gitbay/issue-template.md= (and optional
363=issue-template-<name>.md= variants) to the default branch. =gitbay 383=issue-template-<name>.md= variants) to the default branch. =gitbay
364issue create= prefills =$EDITOR= with the default template, the web 384issue create= prefills =$EDITOR= with the default template, the web