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.