1. Introdução

Uma das experiências mais frustrantes que alguém pode ter como um usuário de programa é submeter um relatório de problema apenas para vê-lo ser sumariamente fechado com uma informação curta e inutil como não é um bug ou PR falso. De forma similar, uma das experiências mais frustrantes para um desenvolvedor de software é ser inundado com relatórios de problemas que não são realmente relatórios de problemas mas sim solicitações de suporte, ou então que contenham pouca ou nenhuma informação sobre como o problema ocorre e como reproduzi-lo.

Este documento procura descrever como escrever bons relatórios de problema. O que, você pergunta, é um bom relatório de problema? Bem, indo direto ao final, um bom relatório de problemas é aquele que se pode analisar e tratar rapidamente, para a satisfação mutua do usuário e do desenvolvedor.

Embora o foco primário deste artigo seja a elaboração de relatórios de problemas no FreeBSD, a maior parte dele pode ser aplicada tranquilamente a outros projetos de software.

Observe que este artigo esta organizado de forma temática, e não de forma cronológica, desta forma você deve ler o documento todo antes de enviar um relatório de problema, é melhor trata-lo como um tutorial passo-a-passo.