Lidando com bugs

Python é uma linguagem de programação madura que tem uma reputação estabelecida por ser estável. Para manter esta reputação, os desenvolvedores gostariam de saber de qualquer deficiência que você encontre em Python.

Às vezes, pode ser mais rápido você mesmo corrigir bugs e contribuir com patches para o Python, uma vez que agiliza o processo e envolve menos pessoas. Aprenda como pode fazer isso em :ref:`contribute<contributing-to-python> `.

Erros na documentação

Se você encontrar um erro nesta documentação ou gostaria de propor alguma melhoria, por favor envie um relatório de erro “bug report” para :ref:`tracker<using-the-tracker> `. Se você possui uma sugestão de como corrigi-lo, inclua ela também.

Se você esta com pouco tempo, pode também enviar os relatórios de erros de documentação para o e- mail docs@python.org (erros de funcionalidades podem ser enviados para python-list@python.org). ‘docs@’ é uma lista de e-mail mantida por voluntários; seu pedido será recebido, embora possa levar um tempo para ser processado.

Ver também

Erros na Documentação no rastreador de problemas do Python

Usando o rastreador de defeitos

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.

No campo “Comment”, descreva o problema com detalhes, incluindo o que você esperava que acontecesse e o que aconteceu. Esteja certo de incluir quaisquer módulos de extensão envolvidos, e que hardware e plataforma de software você está usando (incluindo informações sobre versão quando pertinente).

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.

Ver também

Como Reportar Bugs eficientemente

Artigo que entra em algum detalhe sobre como criar um registro de bug (defeitos) útil. Descreve que tipo de informação é útil e por quê.

Guia para escrever relatório de defeitos

Informação sobre como escrever um bom registro de erro. Algumas coisas são específicas do Projeto Mozilla, mas descrevem boas práticas em geral.

Começando a contribuir com Python por conta própria

Além de apenas reportar erros que encontrar, você é bem vindo a submeter pacotes para corrigi-los. Você pode encontrar mais informações em como começar a contribuir para o Python no Python Developer’s Guide. Se possuir mais questões, o `core-mentorship mailing list`_é um lugar amigável para toda e qualquer questão relativa ao processo de correção de problemas em Python.