[Feature] Label a first issue, and write down how accepted and declined are decided #596

New issue

Closed

opened 2026-07-22 16:18:14 +00:00 by brenno · 1 comment

brenno commented

2026-07-22 16:18:14 +00:00

Owner

Found in the pre-publication contributor-journey review.

Evidence: the repository has ten labels — accepted, bug, declined, docs, duplicate, enhancement, needs-info, privacy, security, triage — and none of them is good first issue or help wanted. Before this review the seven open issues were all large: #518 structural debt, #520 release engineering, #541 sidecars to git, #555, #556, #563, #564. There is no GOVERNANCE.md or MAINTAINERS.md.

Why this matters now: AUTHORS.md:16 invites contributors to "add yourself here in your first pull request" while there is nothing sized for a first pull request to point at. The tracker already has a decision process — triage → accepted | declined | needs-info is visibly in use — but it exists only as label names, so a newcomer cannot tell whether a proposal gets an answer or disappears. For a launch whose stated purpose is involving a wider group of people, that is the gap that decides whether anyone stays.

Proposal: add a good first issue label and tag two or three genuinely small items — this review produced several suitable ones (the placeholder email, the Nieuw tab label, the stale file paths in GIT_STORAGE.md, the committed golden failure artefacts). Then six lines in docs/CONTRIBUTING_GUIDELINES.md under Issue Tracking describing the triage path the labels already encode. No governance document needed for one maintainer.

Found in the pre-publication contributor-journey review. **Evidence:** the repository has ten labels — `accepted, bug, declined, docs, duplicate, enhancement, needs-info, privacy, security, triage` — and none of them is `good first issue` or `help wanted`. Before this review the seven open issues were all large: #518 structural debt, #520 release engineering, #541 sidecars to git, #555, #556, #563, #564. There is no `GOVERNANCE.md` or `MAINTAINERS.md`. **Why this matters now:** `AUTHORS.md:16` invites contributors to "add yourself here in your first pull request" while there is nothing sized for a first pull request to point at. The tracker already *has* a decision process — `triage → accepted | declined | needs-info` is visibly in use — but it exists only as label names, so a newcomer cannot tell whether a proposal gets an answer or disappears. For a launch whose stated purpose is involving a wider group of people, that is the gap that decides whether anyone stays. **Proposal:** add a `good first issue` label and tag two or three genuinely small items — this review produced several suitable ones (the placeholder email, the `Nieuw` tab label, the stale file paths in GIT_STORAGE.md, the committed golden failure artefacts). Then six lines in `docs/CONTRIBUTING_GUIDELINES.md` under *Issue Tracking* describing the triage path the labels already encode. No governance document needed for one maintainer.

brenno added the

enhancement

docs

labels

2026-07-22 16:18:14 +00:00

brenno referenced this issue from a commit

2026-07-22 17:07:10 +00:00

docs: maak het bijdragerspad waar wat het belooft (#588 #625 #642 #596 #595 #594)

brenno referenced this issue from a commit

2026-07-22 17:12:52 +00:00

docs: maak het bijdragerspad waar wat het belooft (#588 #625 #642 #596 #595 #594)

brenno referenced this issue