pypa / pypa/packaging.python.org
Process of proposing (new) specifications may not sufficiently clearly explained
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- Python
- Sterne
- 1.7k
- Forks
- 1.7k
- Ø Merge
- 3 T. 12 Std.
- Gemergte PRs (30 T.)
- 4
Beschreibung
From https://discuss.python.org/t/adding-a-default-extra-require-environment/4898/48?u=pradyunsg
I found this: https://www.pypa.io/en/latest/specifications/#proposing-new-specifications but honestly it’s quite confusing and not really helpful.
I try to understand:
- How to obtain a PEP number ?
- Where should I go to open the PEP ?
- Is the PR to " Python Packaging User Guide repository" the PEP itself ? Or it’s a completely different process and shall be done once we have reached consensus in the PEP ?
- Is there a template I can follow ?
I feel that these are all legitimate questions about the process that we don't clarify well enough, and we should possibly clarify each of these points in/near the "Proposing new specifications" section.
Beitragsleitfaden
Für dieses Repository ist kein Beitragsleitfaden indexiert
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Lies zunächst den im Issue verlinkten Abschnitt „Proposing new specifications“ und vergleiche ihn mit den vier aufgeworfenen Fragen. Aktualisiere die Anleitung so, dass sie erklärt, wie man eine PEP-Nummer erhält, wo man eine PEP eröffnet, wie sich der packaging.python.org PR auf den PEP-Prozess bezieht und ob eine Vorlage vorhanden ist. Als erledigt gilt die Aufgabe, wenn ein Neuling den Prozess ohne die genannte Verwirrung nachvollziehen kann.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Bereich
- documentation
- Issue-Typ
- Dokumentation
- Schwierigkeit
- 2/5
- Geschätzter Aufwand
- 1-3 Stunden
- Aktivitätsstatus
- Veraltet
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 45/100