S'attaquer aux bogues¶
Python est un langage de programmation robuste réputé pour sa stabilité. Afin de maintenir cette réputation, les développeurs souhaitent connaître tout problème que vous pourriez rencontrer dans Python.
Il est parfois plus rapide de réparer les bogues soi-même et d'en proposer les correctifs, ça simplifie le processus et implique moins de monde. Apprenez à contribuer.
Bogues de documentation¶
Si vous trouvez un bogue dans cette documentation ou si vous désirez proposer une amélioration, si cela concerne aussi la documentation en anglais, ouvrez un rapport sur le tracker décrivant en anglais le bogue et où vous l'avez trouvé. Si le problème ne touche que la traduction en français, ouvrez un ticket sur https://github.com/python/python-docs-fr/issues, ou venez nous en toucher un mot sur le canal #python-fr sur freenode (https://webchat.freenode.net/). Si vous avez une suggestion de correction, merci de l'inclure également.
Si vous êtes limité par le temps, vous pouvez aussi envoyer un courriel à docs@python.org (les bogues de comportement peuvent être envoyés à python-list@python.org). « docs@ » est une liste de diffusion gérée par des volontaires, votre requête sera vue, mais elle peut prendre un moment pour être traitée.
Voir aussi
Documentation bugs sur le gestionnaire de tickets de Python
Utilisation du gestionnaire de tickets Python¶
Issue reports for Python itself should be submitted via the GitHub issues tracker (https://github.com/python/cpython/issues). The GitHub issues tracker offers a web form which allows pertinent information to be entered and submitted to the developers.
The first step in filing a report is to determine whether the problem has already been reported. The advantage in doing so, aside from saving the developers' time, is that you learn what has been done to fix it; it may be that the problem has already been fixed for the next release, or additional information is needed (in which case you are welcome to provide it if you can!). To do this, search the tracker using the search box at the top of the page.
If the problem you're reporting is not already in the list, log in to GitHub. If you don't already have a GitHub account, create a new account using the "Sign up" link. It is not possible to submit a bug report anonymously.
Being now logged in, you can submit an issue. Click on the "New issue" button in the top bar to report a new issue.
The submission form has two fields, "Title" and "Comment".
For the "Title" field, enter a very short description of the problem; less than ten words is good.
Dans le champ « Commentaire », décrivez le problème de manière détaillée, incluant ce à quoi vous vous attendiez et ce qui s'est vraiment produit. Assurez-vous d'y inclure les éventuels modules d'extensions impliqués et la plateforme matérielle et logicielle vous utilisiez (en incluant les informations de versions).
Each issue report will be reviewed by a developer who will determine what needs to be done to correct the problem. You will receive an update each time an action is taken on the issue.
Voir aussi
- Comment signaler des bogues de manière efficace (en anglais)
Article qui entre dans les détails sur la manière de créer un rapport de bogue utile. Il décrit quel genre d'information est utile et pourquoi elle est utile.
- Bug Report Writing Guidelines
Conseils pour écrire un bon rapport de bogue. Certains sont spécifiques au projet Mozilla mais présentent des bonnes pratiques générales.
Commencer à contribuer à Python vous-même¶
Au-delà de simplement remonter les bogues que vous trouvez, il est aussi apprécié d'y attacher des correctifs. Vous pouvez trouver plus d'informations pour débuter la rédaction de correctifs dans le Python Developer's Guide. Si vous avez des questions, le core-mentorship mailing list est un endroit amical pour obtenir des réponses à toutes les questions à propos du processus de corrections de bugs dans Python.