pypa / pypa/packaging.python.org
Process of proposing (new) specifications may not sufficiently clearly explained
Nessuno ha ancora preso questa issue.
- Lingua principale
- Python
- Stelle
- 1.7k
- Fork
- 1.7k
- Merge medio
- 3g 12h
- PR unite (30g)
- 4
Descrizione
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.
Guida per i contributori
Nessuna guida per i contributori indicizzata per questo repository
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Direzione di ricerca
Inizia leggendo la sezione "Proposing new specifications" collegata nell'issue e confrontala con le quattro domande sollevate. Aggiorna la guida in modo che spieghi come ottenere un numero PEP, dove aprire una PEP, in che modo il PR di packaging.python.org si rapporta al processo PEP e se esiste un modello. Il lavoro è completato quando un nuovo contributore può seguire il processo senza la confusione citata.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Valutazione
- Ambito
- documentation
- Tipo di issue
- Documentazione
- Difficoltà
- 2/5
- Tempo stimato
- 1-3 ore
- Stato di attività
- Ferma
- Chiarezza
- Abbastanza chiara
- Idoneità per principianti
- 45/100