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 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 corrigir isto, inclua isso 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 sera
recebido, embora possa levar um tempo para ser processado.

Ver também: Documentation bugs no rastreador de problemas do Python


Usando o rastreador de defeitos
===============================

Os relatórios de bugs da linguagem Python podem ser submetidas via o
Python Bug Tracker (https://bugs.python.org/). O rastreador de
defeitos oferece um formulário na Web que permite que informações
pertinentes sejam registradas e submetidas aos desenvolvedores.

O primeiro passo para preencher um relatório é determinar se o
problema já foi relatado. A vantagem, além de poupar o tempo dos
desenvolvedores, é que você aprende o que foi feito para corrigi-lo;
pode ser que o problema já tenha sido corrigido para o próximo
lançamento, ou que seja necessária informação adicional (nesse caso
você é bem vindo para fornecer essa informação!). Para fazer isso,
busque o banco de dados de defeitos usando a caixa de busca no topo da
página.

Se o problema que você está reportando já não estiver no rastreador de
bug, volte ao rastreador de defeitos de Python e faça o login. Se você
ainda não tem uma conta, selecione o link "Registrar" ou, se você usa
OpenID, um dos logos OpenID na barra lateral. Não é possível reportar
um defeito anonimamente.

Já logado, você pode submeter um defeito. Selecione o link "Create
New" na barra lateral para abrir o formulário para reportar o "bug".

O formulário tem um número de campos. Para o campo "Title", digite uma
descrição *muito* curta do problema; menos de dez palavras é
suficiente. No campo "Type", selecione o tipo do seu problema;
selecione também "Component" e "Versions" aos quais o bug se refere.

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).

Cada registro de "bug" será designado a um desenvolvedor que irá
determinar o que precisa ser feito para corrigir o problema. Você
receberá um update cada vez que houver uma ação em relação ao "bug".

Ver também:

  Como relatar "Bugs" efetivamente
  <http://www.chiark.greenend.org.uk/~sgtatham/bugs.html>`_
     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ê.

  Orientações para descrição de erros
     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.
