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.
