pypa / pypa/packaging.python.org
New tutorials: write section to define and describe "package"
Personne n'a encore pris cette issue.
- Langage dominant
- Python
- Étoiles
- 1.7k
- Forks
- 1.7k
- Merge moyen
- 3 j 12 h
- PR mergées (30 j)
- 4
Description
(For more information about this issue, please see #194).
We need a short section to follow the prerequisites section (see #196) (i.e., as its own file). It should satisfy the following goals:
- explain what a distribution package is
- explain how a distribution package differs from import packages and modules
- use the terminology that the wider Python Packaging User Guide uses, so the terminology is familiar if the reader turns to another part of the guide
I also think it would be helpful if the section could illustrate each point with some kind of example, either a made-up example or a real-world example, if it's not too complicated.
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!
Guide de contribution
Aucun guide de contribution indexé pour ce dépôt
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.
Piste de recherche
Commencez par examiner la section des prérequis indiquée dans l’issue ainsi que les entrées du glossaire de Python Packaging User Guide consacrées aux distribution packages, import packages et modules, qui y sont liées. Le travail est terminé lorsqu’un fichier de section autonome suit les prérequis, utilise la terminologie du guide et contient des exemples clairs distinguant chaque concept ; soumettez les modifications à la develop branch.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- python
- Domaine
- documentation
- Type d'issue
- Documentation
- Difficulté
- 2/5
- Temps estimé
- 1-3 heures
- Activité
- À l'abandon
- Clarté
- Clairement spécifiée
- Accessibilité débutants
- 48/100