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 corrigir bugs e contribuir com patches para o Python, uma vez que agiliza o processo e envolve menos pessoas. Aprenda como contribuir.
Problemas de documentação¶
Se você achar um bug nesta documentação ou gostaria de propor uma melhoria, por favor envie um relatório para o rastreador de defeitos. Se você tem uma sugestão de como corrigir, coloque-a 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
- Problemas de documentação
Uma lista de problemas na documentação que foram reportado no rastreador de defeitos do Python.
- Rastreando defeitos
Visão geral do processo de reportar uma melhoria no rastreador.
- Ajudando com documentação
Guia completo para interessados em contribuir com a documentação 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 defeitos eficientemente
Artigo que dá alguns detalhes sobre como criar um registro de 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 relatório de defeito. 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 reportar erros que encontrar, você é bem vindo a submeter suas próprias correções. 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, a core-mentorship mailing list é um lugar amigável para toda e qualquer questão relativa ao processo de correção de problemas em Python.