Problem
CONTRIBUTING.md and CONTRIBUTING.zh-CN.md tell contributors to claim an
issue in a comment, but they do not document the repository's exact
self-assignment commands.
The workflow in .github/workflows/take.yml only runs when the complete
comment body is exactly take or untake. A natural-language comment such as
“I'd like to work on this issue” therefore does not assign the contributor and
does not explain why nothing happened.
The self-assignment behavior was introduced by #3774 for #3773, but its
user-facing commands are currently only discoverable by reading the workflow
or the old issue.
Desired outcome
Update both contribution guides to document that:
- a standalone
take comment self-assigns an unclaimed issue;
- a standalone
untake comment removes the contributor's assignment;
- other claim text does not trigger the workflow.
Keep the English and Chinese guides synchronized. This issue does not propose
changing the workflow behavior.
Alternatives or workarounds
Contributors can discover the commands by reading
.github/workflows/take.yml or the closed implementation issue, but the
contribution guide should explain the supported claim mechanism directly.
Problem
CONTRIBUTING.mdandCONTRIBUTING.zh-CN.mdtell contributors to claim anissue in a comment, but they do not document the repository's exact
self-assignment commands.
The workflow in
.github/workflows/take.ymlonly runs when the completecomment body is exactly
takeoruntake. A natural-language comment such as“I'd like to work on this issue” therefore does not assign the contributor and
does not explain why nothing happened.
The self-assignment behavior was introduced by #3774 for #3773, but its
user-facing commands are currently only discoverable by reading the workflow
or the old issue.
Desired outcome
Update both contribution guides to document that:
takecomment self-assigns an unclaimed issue;untakecomment removes the contributor's assignment;Keep the English and Chinese guides synchronized. This issue does not propose
changing the workflow behavior.
Alternatives or workarounds
Contributors can discover the commands by reading
.github/workflows/take.ymlor the closed implementation issue, but thecontribution guide should explain the supported claim mechanism directly.