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

Problemas de documentação

Se você achar um bug nesta documentação ou gostaria de propor uma melhoria, por favor envie um relatório para o rastreador de defeitos. Se você tem uma sugestão de como corrigir, coloque-a 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 será recebido, embora possa levar um tempo para ser processado.

Ver também

Problemas de documentação

Uma lista de problemas na documentação que foram reportado no rastreador de defeitos do Python.

Rastreando defeitos

Visão geral do processo de reportar uma melhoria no rastreador.

Ajudando com documentação

Guia completo para interessados em contribuir com a documentação 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, pesquise no 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 defeitos, volte ao rastreador de defeitos de Python e faça o login. Se você ainda não tem uma conta, selecione o link “Register” ou, se você usa OpenID, use 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 defeitos.

O formulário tem alguns 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 defeito 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 defeito será designado a um desenvolvedor que irá determinar o que precisa ser feito para corrigir o problema. Você receberá um aviso cada vez que houver uma ação em relação ao defeito.

Ver também

Como reportar defeitos eficientemente

Artigo que dá alguns detalhes sobre como criar um registro de defeitos útil. Descreve que tipo de informação é útil e por quê.

Guia para escrever relatório de defeitos

Informação sobre como escrever um bom relatório de defeito. 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 reportar erros que encontrar, você é bem vindo a submeter suas próprias correções. 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, a core-mentorship mailing list é um lugar amigável para toda e qualquer questão relativa ao processo de correção de problemas em Python.