From 645139a09887e7b78918ca31f774017688d3a7a2 Mon Sep 17 00:00:00 2001 From: Rafael Vuijk Date: Wed, 23 Sep 2026 09:45:23 +0000 Subject: [PATCH] One issue template, and the labels that are left are the ones in use Happypig375 on #1468: condense the templates, and reorganise the labels. The four type templates are one, and it asks for no kind. The same report is a Bug or a Feature depending on what turns out to be true, and the person who hit the behaviour is not the one best placed to say which -- which is the reason given on the issue for having no type templates at all. What a report is useless without is kept: what you ran, what it did, what it should have done, and where that expectation comes from. Blank issues stay enabled beside it, and the two contact links still send questions and ideas to Discussions. The labels are seven where they were twelve. `up-for-grabs`, its three difficulty variants and `good first issue` are gone: reserving work for a newcomer is what they were for, and that is not how this repository is worked now. The six open issues that carried them -- #283, #321, #500, #505, #534, #542 -- are ordinary claimable work, by whoever opens a pull request on them. What is left is `Accepted`, `Opinions wanted`, `Design document` and the four `Area: *`. Part of #1468. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_012sonx8iAspMiwRwokT1Ura --- .github/ISSUE_TEMPLATE/bug_report.md | 22 ------------------- .github/ISSUE_TEMPLATE/goal.md | 24 --------------------- .github/ISSUE_TEMPLATE/maintenance.md | 20 ----------------- .github/ISSUE_TEMPLATE/report.md | 30 ++++++++++++++++++++++++++ .github/ISSUE_TEMPLATE/suggest_idea.md | 21 ------------------ AGENTS.md | 4 ++-- CONTRIBUTING.md | 8 +++++-- 7 files changed, 38 insertions(+), 91 deletions(-) delete mode 100644 .github/ISSUE_TEMPLATE/bug_report.md delete mode 100644 .github/ISSUE_TEMPLATE/goal.md delete mode 100644 .github/ISSUE_TEMPLATE/maintenance.md create mode 100644 .github/ISSUE_TEMPLATE/report.md delete mode 100644 .github/ISSUE_TEMPLATE/suggest_idea.md diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md deleted file mode 100644 index ca723bb8b..000000000 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -name: Report a bug -about: A wrong answer, a crash, a hang, or an answer where there should have been a decline. -title: '' -type: Bug -assignees: '' - ---- - -**The version I use**: - -**Unexpected behaviour or bug**: - - - \ No newline at end of file diff --git a/.github/ISSUE_TEMPLATE/goal.md b/.github/ISSUE_TEMPLATE/goal.md deleted file mode 100644 index 1e4968d5a..000000000 --- a/.github/ISSUE_TEMPLATE/goal.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -name: State a goal -about: State a triaged outcome or initiative; it may start without sub-issues and generate work over time. -title: '' -type: Goal -assignees: '' - ---- - -**What should be true**: - -**What happens today, if anything**: - -**Where it comes from** (optional): diff --git a/.github/ISSUE_TEMPLATE/maintenance.md b/.github/ISSUE_TEMPLATE/maintenance.md deleted file mode 100644 index c47194144..000000000 --- a/.github/ISSUE_TEMPLATE/maintenance.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -name: Plan maintenance -about: Improve internal quality without primarily changing user-facing behaviour. -title: '' -type: Maintenance -assignees: '' - ---- - -**What needs maintenance?** - -**Why is it needed?** - -**Definition of done** diff --git a/.github/ISSUE_TEMPLATE/report.md b/.github/ISSUE_TEMPLATE/report.md new file mode 100644 index 000000000..9908e9c5c --- /dev/null +++ b/.github/ISSUE_TEMPLATE/report.md @@ -0,0 +1,30 @@ +--- +name: Open an issue +about: A wrong answer, something missing, an outcome to aim at, or upkeep. The kind is decided at triage — say what happened, not what to call it. +title: '' +assignees: '' + +--- + + + +**What you ran**: + +**What it did**: + +**What it should have done**: diff --git a/.github/ISSUE_TEMPLATE/suggest_idea.md b/.github/ISSUE_TEMPLATE/suggest_idea.md deleted file mode 100644 index 5b5aeafea..000000000 --- a/.github/ISSUE_TEMPLATE/suggest_idea.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -name: Suggest an idea -about: Your ideas might help the project! -title: '' -type: Feature -assignees: '' - ---- - -**The package I want to suggest the idea to**: - - - - - \ No newline at end of file diff --git a/AGENTS.md b/AGENTS.md index c5c63854a..668ce7b6d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -488,8 +488,8 @@ Then: once answered, closed unless a work item came of it. **Triage is part of the first answer, not a pass of its own.** An issue with no type is - untriaged, and the reply that engages with it is where the type, the milestone and the labels - go on -- not a later sweep, which is one more thing to forget and leaves the tracker wrong in + untriaged -- which every issue is when it arrives, the one template asking for no kind -- and + the reply that engages with it is where the type, the milestone and the labels go on -- not a later sweep, which is one more thing to forget and leaves the tracker wrong in the meantime. A pull request is not triaged: it carries the issue it says it is `Part of`, and a type on it would be that issue's type written twice. A discussion is triaged by the category it is in; what it needs is an answer, and an issue only if work came of it. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 24c467594..7cfcfecd5 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -127,8 +127,12 @@ request saying `Part of #n` is the work claim. Questions and requests for opinions are **Discussions**, not issues -- the Q&A and Ideas categories -- and are answered there; an issue that turns out to be one is redirected and, once -answered, closed unless a work item came of it. `up-for-grabs` marks an issue reserved for a -newcomer. +answered, closed unless a work item came of it. + +There is **one issue template**, and it asks for no kind: what you ran, what it did, what it +should have done. The kind is decided at triage, because the same report is a Bug or a Feature +depending on what turns out to be true, and the person who hit the behaviour is not the person +best placed to say which. Blank issues are enabled beside it. Who is *working* an issue is whoever has an open pull request on it, draft or not, saying `Part of #n`: the pull request is the claim, a week without a push or a comment on it makes the