pypa / pypa/packaging.python.org

New tutorials: write section to describe sources of packages

Aperta
#200 2 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

component: tutorials
Lingua principale
Python
Stelle
1.7k
Fork
1.7k
Merge medio
3g 12h
PR unite (30g)
4

Descrizione

(For more information about this issue, please see #194).

We need a short section to follow the "What's a package?" section (see #199) (i.e., as its own file). It should satisfy the following goals (in no particular order):

  • explain that packages can be distributed through many channels (e.g., downloaded from PyPI with a tool like pip, an archive downloaded from a website, a VCS repository)
  • explain that PyPI is an extremely popular way of getting packages but not the only way
  • explain that PyPI is an index of packages, but not the only possible index
  • illustrate the point with an example (maybe mention a popular package, then describe how it can be found on PyPI, in a VCS repository, and downloaded from the project's website)

In short, this section should answer the question, Where do packages come from?

When opening pull requests for this issue, please submit to the develop branch. If you have questions that concern contributing more generally, please use issue #194. Otherwise, feel free to comment with questions or feedback. Thanks!

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Direzione di ricerca

Inizia leggendo la sezione esistente "What's a package?" e le issue correlate #194 e #199. Aggiungi, in un file separato, una breve sezione che spieghi i canali di distribuzione dei pacchetti, PyPI e altri indici, oltre a un esempio di pacchetto che includa PyPI, un repository VCS e il sito web del progetto. Invia la pull request al branch develop.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
python
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
2/5
Tempo stimato
1-3 ore
Stato di attività
Ferma
Chiarezza
Specificata chiaramente
Idoneità per principianti
55/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.