From 5b48b85159b40f0f6b0f2e5da03934cef931fa31 Mon Sep 17 00:00:00 2001 From: Michael Brooks Date: Thu, 2 Jul 2026 15:45:15 -0700 Subject: [PATCH 1/5] chore: add chore + security labels and align release notes categories MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Introduce a `chore` label for maintainer PRs (CI, build tooling, release scaffolding, repo files) matching the conventional-commit `chore:` prefix already in use, plus a `security` label for vulnerability fixes and hardening. Rework `.github/release.yml` to match the labels that actually exist on the repo โ€” the prior config referenced non-existent `build`, `code health`, `docs`, and `security` labels, so those changelog sections silently fell through to "Other changes". Also splits `dependencies` into its own section so Dependabot PRs don't drown out real chores. --- .github/maintainers_guide.md | 2 +- .github/release.yml | 17 ++++++++++------- 2 files changed, 11 insertions(+), 8 deletions(-) diff --git a/.github/maintainers_guide.md b/.github/maintainers_guide.md index 7ce7423..01b38a8 100644 --- a/.github/maintainers_guide.md +++ b/.github/maintainers_guide.md @@ -111,7 +111,7 @@ Patch and minor updates are auto-approved and auto-merged via the - Feature requests for new skills should be discussed in the issue before implementation begins. - Labels: `bug` for confirmed issues, `enhancement` for feature requests, - `build` for CI/tooling changes. + `chore` for CI/tooling changes. --- diff --git a/.github/release.yml b/.github/release.yml index b2574b7..eb00dc9 100644 --- a/.github/release.yml +++ b/.github/release.yml @@ -1,6 +1,9 @@ # https://docs.github.com/en/repositories/releasing-projects-on-github/automatically-generated-release-notes#configuring-automatically-generated-release-notes changelog: categories: + - title: ๐Ÿ”’ Security + labels: + - security - title: ๐Ÿš€ Enhancements labels: - enhancement @@ -9,16 +12,16 @@ changelog: - bug - title: ๐Ÿ“š Documentation labels: - - docs - - title: ๐Ÿค– Build + - documentation + - title: ๐Ÿงช Tests labels: - - build - - title: ๐Ÿงช Testing/Code Health + - test + - title: ๐Ÿงน Chores labels: - - code health - - title: ๐Ÿ”’ Security + - chore + - title: โฌ†๏ธ Dependencies labels: - - security + - dependencies - title: ๐Ÿ“ฆ Other changes labels: - "*" From ea06d05d1e1d3c1a9dd7a23265d5a879afdfc995 Mon Sep 17 00:00:00 2001 From: Michael Brooks Date: Thu, 2 Jul 2026 16:12:23 -0700 Subject: [PATCH 2/5] chore: move Security back to original position in release.yml Restores the Security category to its prior slot near the bottom of the changelog category list. --- .github/release.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/release.yml b/.github/release.yml index eb00dc9..c646c75 100644 --- a/.github/release.yml +++ b/.github/release.yml @@ -1,9 +1,6 @@ # https://docs.github.com/en/repositories/releasing-projects-on-github/automatically-generated-release-notes#configuring-automatically-generated-release-notes changelog: categories: - - title: ๐Ÿ”’ Security - labels: - - security - title: ๐Ÿš€ Enhancements labels: - enhancement @@ -22,6 +19,9 @@ changelog: - title: โฌ†๏ธ Dependencies labels: - dependencies + - title: ๐Ÿ”’ Security + labels: + - security - title: ๐Ÿ“ฆ Other changes labels: - "*" From 8b6f2ed0221acfea692aab89230903f1a46c421f Mon Sep 17 00:00:00 2001 From: Michael Brooks Date: Thu, 2 Jul 2026 16:37:23 -0700 Subject: [PATCH 3/5] chore: rename documentation label to docs Match the shorter `docs` form used across other slackapi projects. The GitHub label itself was renamed in place (preserves existing PR/issue associations); this updates the `.github/release.yml` reference to match. --- .github/release.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/release.yml b/.github/release.yml index c646c75..cc30983 100644 --- a/.github/release.yml +++ b/.github/release.yml @@ -9,7 +9,7 @@ changelog: - bug - title: ๐Ÿ“š Documentation labels: - - documentation + - docs - title: ๐Ÿงช Tests labels: - test From cf285ebfe1f9585a66f56c0f6ac6897b2244b1fc Mon Sep 17 00:00:00 2001 From: Michael Brooks Date: Thu, 2 Jul 2026 17:04:23 -0700 Subject: [PATCH 4/5] chore: add Build category and build label Match slack-cli's `build` label ("Changes to compilation and CI processes", color #615196) for CI and build-tooling PRs. Narrows the `chore` scope to repo files, release scaffolding, and general maintenance. --- .github/release.yml | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.github/release.yml b/.github/release.yml index cc30983..c9fc4cc 100644 --- a/.github/release.yml +++ b/.github/release.yml @@ -10,6 +10,9 @@ changelog: - title: ๐Ÿ“š Documentation labels: - docs + - title: ๐Ÿค– Build + labels: + - build - title: ๐Ÿงช Tests labels: - test From 4878e0178b0254d92ceb4e7c107a159fb1190579 Mon Sep 17 00:00:00 2001 From: Michael Brooks Date: Thu, 2 Jul 2026 19:12:48 -0700 Subject: [PATCH 5/5] docs: expand Issue Triage labels list in maintainers guide Documents build, chore, security, docs, test, and dependencies labels alongside bug/enhancement, so contributors have a single reference for which label applies to which kind of change. --- .github/maintainers_guide.md | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/.github/maintainers_guide.md b/.github/maintainers_guide.md index 01b38a8..ef6b98d 100644 --- a/.github/maintainers_guide.md +++ b/.github/maintainers_guide.md @@ -110,8 +110,16 @@ Patch and minor updates are auto-approved and auto-merged via the checking whether the relevant live `docs.slack.dev` page has changed. - Feature requests for new skills should be discussed in the issue before implementation begins. -- Labels: `bug` for confirmed issues, `enhancement` for feature requests, - `chore` for CI/tooling changes. +- Labels: + - `bug` โ€” confirmed defects + - `enhancement` โ€” feature requests and new functionality + - `docs` โ€” documentation-only changes + - `test` โ€” test-only changes + - `build` โ€” CI, GitHub Actions, and build/compilation processes + - `chore` โ€” repo structure, required files, release scaffolding, general maintenance + - `dependencies` โ€” dependency updates (Dependabot applies this automatically) + - `security` โ€” vulnerability fixes, hardening, and security audit findings + (apply alongside `bug`/`build`/`dependencies` as appropriate) ---