python / python/devguide

Clarify issue/PR choreography

Ouverte
#1,815 8 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Langage dominant
Python
Étoiles
2.1k
Forks
1k
Merge moyen
2 j 12 h
PR mergées (30 j)
12

Description

From a discussion with @picnixz:

I think the problem with the devguide is the first sentence is "Create an issue that describes the change" and you'll see the mention to DPO only during creation. We can improve that
I would expect people to read the issue template correctly and understand that something is not trivial
and more importantly: WAIT for triagers to decide whether it's ok or not as an issue
There are obvious cases where the issue doesn't a triager for validation, like a clear bug (and even this is subject to interpretation sometimes) but the process issue+PR is the worst for triagers, especially when the PR is automated.

This might be a duplicate of other feedback here in issues, but I wanted to capture it before going back to $WORK.

Guide de contribution

Ouvrir le guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Piste de recherche

Commencez par localiser les instructions d’ouverture du devguide et le modèle d’issue, puis examinez où sont introduites les consignes concernant DPO et les triagers. Précisez que les contributors doivent attendre la validation d’un triager avant d’ouvrir une PR, tout en signalant la discussion autour des bugs évidents. C’est terminé lorsque le workflow issue-to-PR et les exceptions sont explicites pour les contributors.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Domaine
documentation
Type d'issue
Documentation
Difficulté
3/5
Temps estimé
1-2 jours
Activité
Active
Clarté
Plutôt claire
Accessibilité débutants
52/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.