3. Preparação

Uma boa regra a ser seguida sempre é realizar uma busca a respeito do assunto antes de enviar um relatório de problema. Pode ser que o seu problema já tenha sido reportado anteriormente; pode ser que esteja sendo debatido nas listas de discussão ou que tenha sido recentemente; pode até ser que o problema já tenha sido corrigido em uma versão mais recente do que a que você está utilizando. Você deve portanto verificar em todos os lugares óbvios antes de enviar o relatório de problema. Para o FreeBSD, isto significa:

• A lista de Perguntas e Respostas mais Frequentes sobre o FreeBSD (FAQ). A FAQ tem por objetivo fornecer respostas para uma grande variedade de perguntas, tais como as que dizem respeito a compatibilidade de hardware, aplicações do usuário, Configuração do kernel, etc.

• As listas de discussão — se você não está inscrito, utilize a busca do histórico no web site do FreeBSD. Se o seu problema não tiver sido discutido nas listas, você pode tentar enviar uma mensagem sobre ele e aguardar alguns dias para ver se alguém consegue perceber algo que você tenha deixado passar desapercebido.

• Opcionalmente, na internet inteira — utilize seu mecanismo de busca preferido para localizar referências sobre o seu problema. Você pode encontrar referências a ele em mensagens de listas de discussão ou de grupos de noticias dos quais você nunca ouviu falar ou nos quais sequer pensou em procurar.

• Na sequência, verifique o banco de dados com os relatórios de problema do FreeBSD (GNATS). A menos que o seu problema seja recente ou muito obscuro, existe uma boa chance dele já ter sido reportado.

• E o mais importante, você deve verificar se a documentação existente no código base não endereça o seu problema.

  Para o código base do FreeBSD você deve estudar cuidadosamente o conteúdo do arquivo /usr/src/UPDATING disponível no seu sistema de arquivos ou a sua versão mais recente no Repositório Subversion. (Esta informação é vital se você estiver atualizando de uma versão para outra — especialmente se estiver atualizando para o FreeBSD-CURRENT).

  No entanto, se o problema é com algo que foi instalado como uma parte da coleção de ports do FreeBSD você deve consultar o /usr/ports/UPDATING (para os ports individuais) ou o /usr/ports/CHANGES (para mudanças que afetam a Coleção de Ports inteira). Estes arquivos também estão disponíveis no SVNWeb, nos urls http://svnweb.freebsd.org/ports/head/UPDATING e http://svnweb.freebsd.org/ports/head/CHANGES respectivamente.