Lidando com bugs
****************

O Python é uma linguagem de programação madura que estabeleceu uma
reputação pela estabilidade. A fim de manter esta reputação os
desenvolvedores gostariam de saber de quaisquer deficiências que você
achar no Python.

Às vezes,  pode ser mais rápido consertar os bugs você mesmo e
contribuir com patches para o Python como isso agiliza o processo e
envolve menos pessoas. Aprenda como contribuir.


Bugs na documentação
====================

Se você achar um bug nesta documentação ou gostaria de propor uma
melhoria, por favor submeta um relatório no rastreador. Se você tem
uma sugestão sobre como consertá-lo inclua isso também.

Se você está com pouco tempo você também pode enviar por e-mail os
relatórios dos bugs na documentação para docs@python.org (erros
comportamentais podem ser enviados para python-list@python.org). O
'docs@' é uma lista de e-mail mantida por voluntários; seu pedido será
notado, embora possa levar um tempo para ser processado.

Ver também:

  Bugs na documentação
     Uma lista de bugs na documentação que foram submetidos no
     rastreador de problemas do Python.

  Rastreando problemas
     Visão geral do processo envolvido em reportar uma melhoria no
     rastreador.

  Ajudando com a Documentação
     Guia compreensivo para os indivíduos que estão interessados em
     contribuir com a documentação do Python.

  Documentation Translations
     A list of GitHub pages for documentation translation and their
     primary contacts.


Usando o rastreador de problemas do Python
==========================================

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 se quaisquer módulos de extensão estavam envolvidos, e qual
hardware e plataforma de software você está usando (incluindo
informações sobre a versão quando apropriado).

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 relatório
     de bug útil. Isto descreve qual tipo de informação é útil e por
     quê é útil.

  Bug Writing Guidelines
     Informação sobre como escrever um bom relatório de bug. Um pouco
     disto é específico do Projeto Mozilla, mas descreve boas práticas
     em geral.


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

Além de apenas reportar os bugs que você acha, você é bem-vindo para
submeter patches para consertá-los. Você pode achar mais informações
sobre como começar a fazer patches para o Python no Python Developer's
Guide. Se você tem mais perguntas, a core-mentorship mailing list é um
lugar amigável para obter respostas para qualquer e todas as questões
relativas pertencentes ao processo de conserto de problemas no Python.
