From f90411500d78ef27ebb58f81d57ff633b16c5e79 Mon Sep 17 00:00:00 2001 From: Sebastian Mendel Date: Fri, 13 Nov 2026 16:17:04 +0100 Subject: [PATCH 1/2] docs(release-process): credit the upstream reporter of a mirrored issue A repository that copies upstream issues records the maintainer who copied them as the issue author, so harvest-contributors.sh lists that maintainer as the reporter. The commit-author cross-check cannot show the real reporter, who never appears in the commit range. Add an under-credit case: credit the upstream issue's author with the full reference and drop the maintainer's reporter credit. Found in the netresearch/ofelia v1.2.0 notes: #316 ("[Upstream #341]") was harvested as reported by the maintainer; the reporter is the author of mcuadros/ofelia#341. Signed-off-by: Sebastian Mendel --- skills/github-release/references/release-process.md | 1 + 1 file changed, 1 insertion(+) diff --git a/skills/github-release/references/release-process.md b/skills/github-release/references/release-process.md index f3c6080..e7438cc 100644 --- a/skills/github-release/references/release-process.md +++ b/skills/github-release/references/release-process.md @@ -344,6 +344,7 @@ gh api repos/owner/repo/compare/... --jq '.commits[].author.login?' | ``` One person per line (the `%n` separator keeps multiple co-authors from colliding), deduped; the emails map names back to GitHub accounts. +- **Mirrored issue:** a repository that copies issues from an upstream project (a title such as `[Upstream #341] …`) records the maintainer who copied it as the issue author, so the harvest lists that maintainer as the reporter. Credit the author of the upstream issue instead, with the full reference (`reported by @login in upstream-owner/repo#341`), and drop the maintainer's reporter credit unless the maintainer also reported it. Neither check above shows this case: the reporter never appears in the commit list. netresearch/ofelia holds 72 such issues, all authored by the maintainer (2026-11-13). The compare API caps at 250 commits — for a wider range, run it in two halves. From 42d5ed453981732e93d39ba59c1fcda1c885dda6 Mon Sep 17 00:00:00 2001 From: Sebastian Mendel Date: Fri, 13 Nov 2026 17:06:24 +0100 Subject: [PATCH 2/2] docs(release-process): keep the maintainer's mention for a mirrored issue release-notes-status.sh requires every harvested login in the body, and the harvest lists the maintainer who mirrored the issue. Dropping that mention made the check report MISSING CREDITS. Keep it at the maintainer's change, or as the one who mirrored the issue. Signed-off-by: Sebastian Mendel --- skills/github-release/references/release-process.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/github-release/references/release-process.md b/skills/github-release/references/release-process.md index e7438cc..0110b7f 100644 --- a/skills/github-release/references/release-process.md +++ b/skills/github-release/references/release-process.md @@ -344,7 +344,7 @@ gh api repos/owner/repo/compare/... --jq '.commits[].author.login?' | ``` One person per line (the `%n` separator keeps multiple co-authors from colliding), deduped; the emails map names back to GitHub accounts. -- **Mirrored issue:** a repository that copies issues from an upstream project (a title such as `[Upstream #341] …`) records the maintainer who copied it as the issue author, so the harvest lists that maintainer as the reporter. Credit the author of the upstream issue instead, with the full reference (`reported by @login in upstream-owner/repo#341`), and drop the maintainer's reporter credit unless the maintainer also reported it. Neither check above shows this case: the reporter never appears in the commit list. netresearch/ofelia holds 72 such issues, all authored by the maintainer (2026-11-13). +- **Mirrored issue:** a repository that copies issues from an upstream project (a title such as `[Upstream #341] …`) records the maintainer who copied it as the issue author, so the harvest lists that maintainer as the reporter. Credit the author of the upstream issue as the reporter, with the full reference (`reported by @login in upstream-owner/repo#341`). Neither check above shows this case: the reporter never appears in the commit list. `release-notes-status.sh` still requires every harvested login in the body, the maintainer's included, so keep the maintainer's mention at the change they worked on; where the maintainer had no other part in the release, name them as the one who mirrored the issue (`mirrored as #316 by @maintainer`). netresearch/ofelia holds 72 such issues, all authored by the maintainer (2026-11-13). The compare API caps at 250 commits — for a wider range, run it in two halves.