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 traqueur 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://git.afpy.org/AFPy
/python-docs-fr/issues, ou venez nous en toucher un mot sur le canal
#python-fr sur *libera.chat*
(https://kiwiirc.com/nextclient/#irc://irc.libera.chat/#python-fr). Si
vous avez une suggestion de correction, merci de l'inclure également.

Vous pouvez aussi commenter une discussion sur le forum de discussion
de la documentation.

If you find a bug in the theme (HTML / CSS / JavaScript) of the
documentation, please submit a bug report on the python-doc-theme bug
tracker.

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:

  Bogues de documentation
     Liste des bogues de documentation soumis à l'outil de suivi des
     problèmes Python.

  Outil de suivi des problèmes
     Vue d'ensemble du processus pour proposer une amélioration avec
     l'outil de suivi.

  Aider avec la documentation
     Guide complet pour qui souhaite contribuer à la documentation
     Python.

  Traductions de la Documentation
     Liste de dépôts GitHub où la documentation est traduite, avec les
     personnes à contacter.


Utilisation du gestionnaire de tickets Python
=============================================

Les rapports concernant un problème relatif à Python lui-même doivent
être soumis *via* l'outil de suivi des problèmes de GitHub
(https://github.com/python/cpython/issues). Le gestionnaire de tickets
propose un formulaire Web permettant de saisir des informations
pertinentes à soumettre aux développeurs.

La première étape pour remplir un rapport est de déterminer si le
problème a déjà été rapporté. L'avantage de cette approche, en plus
d'économiser du temps aux développeurs, est d'apprendre ce qui a été
fait pour le résoudre ; il se peut que le problème soit déjà résolu
dans la prochaine version, ou que des informations complémentaires
soient attendues (auquel cas votre contribution est la bienvenue !).
Pour ce faire, cherchez dans le gestionnaire de tickets grâce à la
boîte de recherche en haut de la page.

Si le problème que vous soumettez n'est pas déjà dans la liste,
connectez-vous à GitHub. Si vous n'avez pas déjà un compte GitHub,
créez un nouveau compte en cliquant sur le lien « Sign Up ». Il n'est
pas possible de soumettre un rapport de bogue de manière anonyme.

Une fois connecté, vous pouvez rapporter un problème. Sélectionnez le
bouton *New issue* dans la barre en haut pour ouvrir un nouveau
formulaire de rapport.

Le formulaire de rapport contient deux champs, *Title* et *Comment*.

Dans le champ *Title*, entrez une *très* brève description du problème
rencontré : dix mots ou moins suffiront.

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).

Chaque rapport sera attribué à un développeur qui déterminera ce qui
est nécessaire d'entreprendre pour corriger le problème. Vous recevrez
une notification à chaque action concernant le rapport.

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.

  Guide pour la rédaction de rapports de bogues
     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.
