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.
