Title: Expand self-assignment to help wanted issues after three merged pull requests · Issue #113 · learningequality/.github · GitHub
Open Graph Title: Expand self-assignment to help wanted issues after three merged pull requests · Issue #113 · learningequality/.github
X Title: Expand self-assignment to help wanted issues after three merged pull requests · Issue #113 · learningequality/.github
Description: ❌ This issue is not open for contribution. Visit Contributing guidelines to learn about the contributing process and how to find suitable issues. Overview /assign works only on an issue labelled good first issue. An issue labelled help w...
Open Graph Description: ❌ This issue is not open for contribution. Visit Contributing guidelines to learn about the contributing process and how to find suitable issues. Overview /assign works only on an issue labelled go...
X Description: ❌ This issue is not open for contribution. Visit Contributing guidelines to learn about the contributing process and how to find suitable issues. Overview /assign works only on an issue labelled go...
Opengraph URL: https://github.com/learningequality/.github/issues/113
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Expand self-assignment to help wanted issues after three merged pull requests","articleBody":"\u003c!---HEADER START-->\n\n\u003cimg height=\"20px\" src=\"https://i.imgur.com/c7hUeb5.jpeg\">\n\n❌ **This issue is not open for contribution. Visit \u003ca href=\"https://learningequality.org/contributing-to-our-open-code-base/\" target=\"_blank\">Contributing guidelines\u003c/a>** to learn about the contributing process and how to find suitable issues.\n\n\u003cimg height=\"20px\" src=\"https://i.imgur.com/c7hUeb5.jpeg\">\n\n\u003c!---HEADER END-->\n\n## Overview\n\n`/assign` works only on an issue labelled `good first issue`. An issue labelled `help wanted` alone\ngets no guidance comment, and a contributor who asks for it gets no reply. Maintainers assign all of\nthose by hand.\n\nOpen `help wanted` issues to self-assignment for contributors with three or more merged pull\nrequests. New contributors keep `good first issue` as their route in.\n\n**Complexity:** Medium\n**Target branch:** main\n\n### Context\n\nlearningequality/kolibri#15549 is the case that prompted this. `help wanted` was added, the job ran,\nand `good-first-issue-comment.js:22` returned without posting, because it requires both labels.\n\nThe distinction exists to keep harder issues with contributors who finish things. A merge count\nturns that into something measurable, so the label can open up without losing the intent.\n\n`help wanted` is the parent label in practice. Across kolibri, studio and kolibri-design-system\nthere are no open issues carrying `good first issue` without `help wanted`. In closed history there\nare 18, against 232 carrying both and 170 carrying `help wanted` alone.\n\nThree places key on `good first issue`:\n\n| Place | Today |\n|---|---|\n| `good-first-issue-comment.js:22` | no guidance comment unless both labels |\n| `contributor-issue-comment.js:145` | `/assign` refused unless `good first issue` |\n| `contributor-issue-comment.js:225` | no reply to an assignment request unless both labels |\n\n### The rules after this change\n\n| Issue has | Who can self-assign | Guidance comment |\n|---|---|---|\n| `good first issue` | anyone | comment `/assign`, as today |\n| `help wanted` only | three or more merged pull requests | qualify and `/assign`, otherwise ask |\n| neither | nobody | not open for contribution, as today |\n\n`good first issue` wins when both are present, because it is the more permissive.\n\nEvery existing check still applies, in this order: the commenter is a contributor rather than a core\nmember or bot, the issue is open, it is not already assigned to someone else, and the contributor\nholds fewer than `MAX_ASSIGNED_ISSUES` slots counting issues dropped inside `ASSIGN_COOLDOWN_DAYS`.\n\n### Clarifications\n\n**Which rejection wins.** Someone below the threshold asking for a `help wanted` issue that is\nalready taken hits two reasons at once. \"Already assigned\" wins, because it is the more actionable\none and it is the earlier check today.\n\n**What the count measures.** Merged pull requests anywhere in the organization, public only. The\nthreshold is calibrated against that measure. Restricting it to the community repos would give\nlower counts and would need recalibrating.\n\n**Maintainers bypass all of it.** Every rule here lives in the `/assign` path, so assigning by hand\nstill skips the threshold and the limit. That stays the escape hatch for an experienced contributor\nyou want on something before they reach three.\n\n### The Change\n\n**Count merged pull requests.** Add a helper to `scripts/utils.js` that returns the number of merged\npull requests a contributor has authored in the organization, from one search call:\n\n```\norg:learningequality is:pr is:merged author:\u003clogin>\n```\n\nThat endpoint returns 422 rather than a count when the contributor's activity is private, and also\nfor a deleted or renamed account. Treat that as unknown rather than as zero, and never as a signal\nof anything. A private profile is an ordinary choice, and under this rule it locks someone out\nrather than letting them past, so it is not a way to game the threshold.\n\n**Replace the label gate with the count.** `contributor-issue-comment.js:145` to 153 currently\nrefuses `/assign` without `good first issue`. It instead refuses when the issue carries only\n`help wanted` and the contributor is below the threshold. Line 114 already covers an issue with\nneither label.\n\n**Post guidance on `help wanted`.** `good-first-issue-comment.js:22` posts when `help wanted` is\npresent. The message depends on whether `good first issue` is there too.\n\n**Answer an assignment request.** `contributor-issue-comment.js:225` replies on a `help wanted`\nissue as well, rather than staying silent.\n\n### Messages\n\n- `BOT_MESSAGE_GOOD_FIRST_ISSUE_GUIDANCE` stays as it is, for an issue with `good first issue`.\n- A new guidance message for `help wanted` alone. It says the issue is open for contribution, that\n self-assignment needs three merged pull requests, and that anyone below that should comment to\n ask, because a maintainer assigns those.\n- A new decline for `/assign` below the threshold. It must name the threshold and the contributor's\n current count, and point them at good first issues. A decline with no number reads as arbitrary.\n- A separate decline for an unknown count. It says we cannot read their contribution history, and\n asks them to comment so a maintainer can assign the issue by hand. It must not quote a count, and\n it must not imply they have none.\n- `BOT_MESSAGE_ASSIGN_NOT_GOOD_FIRST_ISSUE` is replaced by that decline.\n\n### Why three\n\nMerged pull requests across recent contributors outside the established cohort:\n\n| Merged PRs | Contributors | Share |\n|---|---|---|\n| 0 | 6 | 25% |\n| 1 | 5 | 21% |\n| 2 | 5 | 21% |\n| 3 | 4 | 17% |\n| 4 or more | 4 | 17% |\n\nThree qualifies 8 of 24 and leaves 16 on the manual path. Two would qualify 13 and leave 11.\n\nThree was chosen because the threshold can be lowered later without cost. Anyone who qualifies at\nthree also qualifies at two, so dropping it only adds people. Raising it takes self-assignment away\nfrom contributors who already had it.\n\nThe count above is org-wide and public, which is what the threshold is calibrated against. A\nper-repo measure would need recalibrating.\n\n### Dependency worth knowing\n\n`good first issue` becomes the only on-ramp. If that queue runs dry, new contributors have no route\nto their first three merges. A maintainer assigning by hand stays the escape hatch, as it is today.\n\n### Out of Scope\n\n- Changing `MAX_ASSIGNED_ISSUES` or `ASSIGN_COOLDOWN_DAYS`.\n- Weighting a merge by size. A merge is a merge.\n- Relabelling the closed issues that carry `good first issue` alone.\n- The welcome header in the issue body, which already appears on `help wanted`.\n\n### Acceptance Criteria\n\n- [ ] Adding `help wanted` posts guidance that states the three merge rule.\n- [ ] Adding `good first issue` posts the existing guidance, and only one guidance comment remains.\n- [ ] `/assign` on a `good first issue` works for anyone, as today.\n- [ ] `/assign` on a `help wanted` issue works at three or more merged pull requests.\n- [ ] `/assign` on a `help wanted` issue below three declines, naming the threshold and the count.\n- [ ] `/assign` on an issue with neither label still gets `BOT_MESSAGE_ISSUE_NOT_OPEN`.\n- [ ] `/assign` on an issue assigned to someone else still gets `BOT_MESSAGE_ALREADY_ASSIGNED`, and\n that message wins over the threshold decline when both apply.\n- [ ] The two issue limit and the cooldown still apply above the threshold.\n- [ ] Asking to work on a `help wanted` issue gets a reply rather than silence.\n- [ ] A contributor whose activity is private, or whose login no longer resolves, gets the unknown\n decline rather than the below-threshold one, and the run does not fail.\n- [ ] The unknown decline quotes no count and points at manual assignment.\n- [ ] `BOT_MESSAGE_ASSIGN_NOT_GOOD_FIRST_ISSUE` is gone, and nothing references it.\n- [ ] Tests cover each label state, and counts of 0, 2, 3 and a failed lookup.\n- [ ] `docs/community-automations.md` describes the three label states.\n\n### Testing\n\nTest in `test-actions`. See\n[testing the automations](https://github.com/learningequality/.github/blob/main/docs/testing-automations.md).\nThe cases need an account outside the organization.\n\n1. Add `help wanted` to an issue. Expect guidance naming the three merge rule.\n2. Add `good first issue` as well. Expect the existing guidance, and one comment rather than two.\n3. Comment `/assign` from an account with fewer than three merges on a `help wanted` issue. Expect\n the decline, with the count.\n4. Comment `/assign` on a `good first issue` from the same account. Expect assignment.\n5. Comment `/assign` on an issue with neither label. Expect the not-open message.\n6. Comment `/assign` from an account whose activity is set to private. Expect the unknown decline,\n with no count quoted and manual assignment offered.\n\n### References\n\n- learningequality/kolibri#15549 is the case that prompted this.\n- #104 gates a second assignment on an open pull request. That gate and the two issue limit hold the\n volume down above this threshold.\n- #107 fixes the race that lets two `/assign` comments both pass the limit.\n\n## AI usage\n\nI used Claude Code to find why no comment was posted, trace every place the two labels gate\nbehaviour, and count merged pull requests across the recent contributor cohort. The threshold and\nthe rule are my decision.\n","author":{"url":"https://github.com/akolson","@type":"Person","name":"akolson"},"datePublished":"2026-10-12T08:39:48Z","url":"https://github.com/learningequality/.github/issues/113"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:d2775501-c972-2026-53bf-96d3a306d0bb |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | 8E30:2E6021:22E1998:2D660DE:6AFFEC4A |
| html-safe-nonce | 8e94e443918ea9169b9b54190745cc07f211c2e274c6bd6fa1e42473ed6d054f |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4RTMwOjJFNjAyMToyMkUxOTk4OjJENjYwREU6NkFGRkVDNEEiLCJ2aXNpdG9yX2lkIjoiMzcwODEzNDY4NDgwMzE5ODAyNyIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 680a7f38b39351d7c2f2ed5627caa510027e4c70e6013f7fb6fdd9e0306a7a41 |
| hovercard-subject-tag | issue:5810822178 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/learningequality/.github/113/issue_layout |
| twitter:image | https://opengraph.githubassets.com/7ad5365f536f1beca859d45f170160d5fa89a40af465701eda119accff92d8a9/learningequality/.github/issues/113 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/7ad5365f536f1beca859d45f170160d5fa89a40af465701eda119accff92d8a9/learningequality/.github/issues/113 |
| og:image:alt | ❌ This issue is not open for contribution. Visit Contributing guidelines to learn about the contributing process and how to find suitable issues. Overview /assign works only on an issue labelled go... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | akolson |
| hostname | github.com |
| expected-hostname | github.com |
| None | 0a0d8686a27478df474dd7415776a7a080cde8838b3cd92ea7601187572e5729 |
| turbo-cache-control | no-preview |
| go-import | github.com/learningequality/.github git https://github.com/learningequality/.github.git |
| octolytics-dimension-user_id | 3926525 |
| octolytics-dimension-user_login | learningequality |
| octolytics-dimension-repository_id | 647407699 |
| octolytics-dimension-repository_nwo | learningequality/.github |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 647407699 |
| octolytics-dimension-repository_network_root_nwo | learningequality/.github |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 16a11879678aaf97e2a42c33ee70830aa084fa37 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width