Reviving / Carrying Forward PRs
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 5/5
- Temps estimé
- Plus d'une semaine
- Accessibilité débutants
- 30/100
- Type d'issue
- Documentation
- Clarté
- À clarifier
- Activité
- À l'abandon
- Stack technique
- git, github
- Domaine
- developer-experience, documentation
Piste de recherche
Commencez par examiner le chapitre de Dev Guide référencé dans l’issue ainsi que l’exemple lié de bpo-19217 et PR-41203. Documentez une procédure de passation, un tutoriel de reprise et des recommandations sur l’attribution du crédit aux contributeurs, y compris les délais de réponse proposés ; le travail sera terminé lorsque le contenu pertinent du guide expliquera clairement ce workflow.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
The Problem: Abandoned PRs
I am wondering about whether it is helpful for contributors to help move forward pull requests where the original contributor seems to have lost momentum for whatever reason. For example, I found bpo-19217 and PR-41203. There had been a long discussion and extensive review on the PR, but the original contributor stopped just short of making some final changes needed for merging. Of course, open source contributors have no obligation to continue working on a pull request, and the review process can definitely be challenging. At the same time, I notice so much core developer time being sunk into pull requests that never land. Some for good reason, but others because the original contributor just can't keep following up.
When I came across this issue, I went ahead and merged the original contributor's changes into a fresh branch on my fork, and did the additional work needed to create a branch ready for merge and to close the bpo, but I stopped short of opening a pull request because I didn't know what the procedure was and I definitely didn't want to step on the original contributor's toes. My changes can be viewed here.
Anyway, I am wondering what we think about this situation. Is there a role for contributors to help push forward pull requests that have lost steam? How can we make sure that both committers are equally recognized for their contribution? Pesumably only one can end up in the commit log, otherwise there will be unstable commits in cpython:main. In an ideal world, this workflow wouldn't be necessary, but I notice that there is so much great work lingering in 80%-complete github pull requests. This also wastes a ton of core dev time, because they review things that don't end up landing when the original contributor can't keep following through.
Role of the Dev Guide
I think that the dev guide can help here by establishing guidelines and procedures for people to do this type of work. For example, this chapter of the dev guide could:
- Establish a procedure for "passing the torch"
- After
nnumber of days of no response from the original contributor, it's fair game for another contributor to merge changes into their own branch and start carrying the issue forward - Or, after
nnumber of days, a new contributor can request to take over with a comment on the bpo or PR. The original contributor hasnadditional days to respond, before it is ok for the new contributor to finish their work.
- After
- Include a tutorial for how to take over:
git remote add original-contributor git@github.com/<other-contributor>/cpython
git merge other/<bpo-####>
- Explain how both contributors will receive credit.
- Langage dominant
- Python
- Étoiles
- 2.1k
- Forks
- 1k
- Merge moyen
- 2 j 12 h
- PR mergées (30 j)
- 12
Guide de contribution
Ouvrir le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de python/devguide
-
type-feature
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
-
type-feature
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
-
topic-building python type-feature
Difficulté 2/5 1-3 heures Accessibilité débutants 65/100
-
needs: decision topic-test type-bug
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
-
topic-dev process type-feature
Difficulté 2/5 1-3 heures Accessibilité débutants 62/100
Toutes les issues de python/devguide
Issues similaires
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 90/100
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 86/100
zostera/django-bootstrap4#894 ·
-
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
use-agent-os/agent-os#3276 ·
-
Difficulté 2/5 1-3 heures Accessibilité débutants 88/100
zephyrproject-rtos/zephyr#119726 ·
-
area/auth bug comp/agent P3 platform/discord type/security
Difficulté 2/5 1-3 heures Accessibilité débutants 88/100
NousResearch/hermes-agent#117848 ·