Skip to content

QEP-2: Standard GitHub Label Set and Labelling Policy#2

Draft
mmcky wants to merge 2 commits into
mainfrom
qep-0002
Draft

QEP-2: Standard GitHub Label Set and Labelling Policy#2
mmcky wants to merge 2 commits into
mainfrom
qep-0002

Conversation

@mmcky

@mmcky mmcky commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

QEP-2: Standard GitHub Label Set and Labelling Policy

Status: Draft · Type: Standard · Discussion: QuantEcon/meta#324

This is the DRAFT of QEP-2, re-recording the label-set decision from QuantEcon/meta#324 as a worked Standard-type QEP — step 2 of QEP-1's rollout. It's opened as a draft so we can keep iterating on the wording before it goes up for a decision; the substantive calls in #324 are all settled.

What it defines

  • The standard label set — 18 core labels (universal) + 2 lecture-extension labels (new-lecture, editor) = 20, with standard names, colours, and descriptions. The core 18 also becomes the org-level default for new repos.
  • The labelling policy — one Type label per issue at triage; unlabelled = needs-triage/normal-priority (and the clarification that "no labels" ≠ "no priority label"); priority is a heat-scale that marks only outliers; question vs discuss and a discuss closing convention; automation labels are bot-applied.
  • The one behavioural change — retire the status labels (in-work / ready / review / blocked) in favour of native GitHub (Draft PRs, "Ready for review", review requests, issue dependencies). Only do-not-merge survives.

Decisions from #324, folded into this draft

Item Resolution (from #324)
Q1 — infrastructure Approved as a distinct Type label, split from maintenance → 20 labels (18 core)
Add discuss (@jstac) In — core label, reuses meta's pink #f904a0, split cleanly from question
Recolour documentation (@xuanguang-li) Done — moved to tan #b08968, off the blue "new content" family
good first issue / help wanted spacing (@longye-tian) Keep the spaces — GitHub's Contribute-page algorithm needs the exact names
Add blocked? No — native issue dependencies + Draft/"Blocked by #N" cover it
Q2 — rollout Pilot lecture-python-programming first, then roll out more widely
Q3 — retire status labels Settled — unanimous in the thread
Guide clarifications (@shlff) Folded into the policy section (unlabelled vs no-priority; discuss exit)
Tooling (@mmcky) qe gh labels sync additive; a separate qe gh labels prune reviews non-standard labels one-by-one

Notes / open to wording feedback

  • infrastructure colour is a placeholder #006b75 — its existing colour (#BF3E89) would clash with the new discuss pink, so it needs a fresh distinct hue. Suggest a better one if you have a preference.
  • Accepting as written means un-folding infrastructure in QuantEcon/cli's labels.yml (it's currently listed as a maintenance alias).
  • @shlff's optional qep-candidate (meta-only) label is deliberately out of scope here — he flagged it for #325, not this rollout.

Decision deadline

To be set by the author. Since #324 reached consensus by its 17 June deadline, this is largely a formalisation — a short comment window (≈1 week) is likely enough.

🤖 Generated with Claude Code

mmcky and others added 2 commits June 17, 2026 19:40
Re-records the label-set decision from QuantEcon/meta#324 as a worked
Standard-type QEP, per QEP-1's rollout. Defines the standard label set
(18 core + 2 lecture), the labelling policy, and the one behavioural
change (retire status labels in favour of native GitHub PR lifecycle).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Apply the final decisions from QuantEcon/meta#324:
- infrastructure split approved (no longer flagged open)
- Q2 rollout is a staged pilot on lecture-python-programming, then wider
- add the separate `qe gh labels prune` step (one-by-one review)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant