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.

Usando o rastreador de problemas do Python

Relatórios sobre bugs no Python em si devem ser submetidos via Rastreador dos Bugs do Python (https://bugs.python.org/). O rastreador dos bugs oferece um formulário web o qual permite que informações pertinentes sejam inseridas e submetidas aos desenvolvedores.

O primeiro passo para preencher um relatório é determinar se o problema já foi reportado. A vantagem em fazê-lo além de poupar o tempo dos desenvolvedores é que você aprende o que foi feito para consertá-lo; pode ser que o problema já foi consertado para o próximo lançamento, ou que informação adicional seja necessária (nesse caso, você é bem-vindo para fornecê-la se você puder!). Para fazer isso procure no banco de dados dos bugs usando a caixa de busca no topo da página.

Se o problema que você está reportando já não estiver no rastreador dos bugs volte ao Rastreador dos Bugs do Python e faça o login. Se você não tem uma conta no rastreador selecione o link “Register” ou se você usa OpenID use um dos logos do fornecedor OpenID na barra lateral. Não é possível submeter um relatório de bug anonimamente.

Estando agora autenticado, você pode submeter um bug. Selecione o link “Create New” na barra lateral para abrir o formulário de relatório do bug.

O formulário de submissão tem um número de campos. Para o campo “Title”, digite uma descrição muito curta do problema; menos de dez palavras é bom. 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 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).

Cada relatório de bug será atribuído a um desenvolvedor que determinará o que precisa ser feito para corrigir o problema. Você receberá uma atualização cada vez que uma ação for tomada sobre o bug.

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.

Diretrizes para relatar bugs

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.