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.
- Documentation Translations
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.