Repository navigation
docs: add issue templates for the issues-only contribution model #1844
Description
Activity
Triage: Priority = Medium
Scored 8/16 with the priority rubric added to
AGENTS.mdin #1891. This card is already approved and sitting in Todo — only Priority was set here, its Status is unchanged.Axis Score Reasoning Severity / impact 3/5 Issues are now the single intake channel for everyone outside the org, and GitHub gives a would-be contributor no explanation when the PR button is missing. Every issue arriving without repro or version information costs maintainer time on the way back. Urgency / staleness 4/5 v2.1.0 milestone, plus specific timing: the #1872 sweep just closed 135 issues telling their reporters to open fresh v2 issues, so an intake spike is arriving into a tracker with no templates. Signal bonuses +1 milestone (v2.1.0) (+1) Total 8 Lands in the Medium band (6-8). Related issues. One connected issue:
- Triage the open issue backlog: backfill v1/v2 labels, close legacy, board the rest #1872 — the deprecation sweep whose closing note explicitly invites re-filing — the wave this would catch
Worth a second look. The timing argument is stronger than the score conveys. If anything in the Medium band should jump the queue, this is the candidate — it gets cheaper the sooner it lands and more expensive with every untemplated issue filed.
Scores are a starting point, not a verdict — the rubric is meant to be overruled when it's plainly wrong, provided the reason is written down.
- added 5 commits that reference this issue
on Aug 1, 2026 - linked a pull request that will close this issuedocs: replace the markdown bug template with GitHub issue forms #1894
on Aug 1, 2026 - added a commit that references this issue
on Aug 1, 2026
Split out of #1820 (phase 6), which is otherwise complete.
Why this matters more now than it used to
External pull requests are off — the repo moved to Collaborators-only in phase 6, and
CONTRIBUTORS.mddocuments the issues-only policy. So issues are now the single intake channel for everyone outside the org.GitHub gives a would-be contributor no explanation when the "Create pull request" button is missing.
CONTRIBUTORS.mdcovers that, but only if they find it. Templates put the policy in front of them at the exact moment they are trying to contribute.There are currently no templates at all —
.github/ISSUE_TEMPLATE/does not exist.Suggested set
SECURITY.md(restored in #1843).Plus
config.ymlwith:blank_issues_enabled: false— so everything lands in a templateCONTRIBUTORS.md(why no PRs),SECURITY.md(private reporting), and the docs siteWorth deciding while writing these
Related
CONTRIBUTORS.mdpolicySECURITY.mdrestored, which the security template should point at