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.

Tradução da documentação

Uma lista de páginas no Github relacionadas à tradução da documentação e respectivos contatos iniciais.

Usando o rastreador de problemas do Python

Relatórios de erros para o Python em si devem ser enviados pelo GitHub Issues Tracker (https://github.com/python/cpython/issues). o GitHub issues tracker oferece um formulário web que permite informações pertinentes serem enviadas para os 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 rastreador usando a caixa de busca no topo da página.

Se o problema que você está relatando ainda não estiver na lista, faça login no GitHub. Se você ainda não tiver uma conta do GitHub, crie uma nova conta usando o link “Sing Up”. Não é possível enviar um relatório de bug anonimamente.

Estando agora autenticado, você pode enviar um problema. Clique no botão “New issue” na barra superior para relatar um novo problema.

O formulário de submissão tem dois campos, “Title” e “Comment”.

Para o campo “Title”, insira uma descrição muito curta do problema; menos de dez palavras é bom.

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 relatorio de erro será revisado por um desenvolvedor que irá determinar o que é necessario para solucionar o problema. Você receberá atualizações para cada ação tomada para o erro.

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.