Tradução e adaptação do debate Stack Overflow question checklist criado por Jon Skeet.
Aqui está uma pequena lista de verificações para fazer após escrever uma pergunta (e para pensar antes de escrever a pergunta):
- Você fez uma busca no site antes de fazer a pergunta? 1
- Você explicou o que já tentou para resolver o seu problema?
- Você escolheu um título bom e descritivo para a sua pergunta?
- Você especificou qual linguagem e plataforma está usando, incluindo o número da versão quando relevante?
- Se sua pergunta inclui código, você o escreveu como um programa resumido e simplificado, mas completo ao ponto de reproduzir o erro no computador de quem tentar responder a sua pergunta? 2
- Se sua pergunta inclui código, você verificou se ele está formatado corretamente? Você sabe como usar Markdown? 3
- Se o seu código não compila, você incluiu o erro exato do compilador?
- Se sua pergunta não inclui código, tem certeza de que não deveria?
- Se o seu programa lançar uma exceção, você incluiu a exceção com a mensagem e o rastreamento de pilha?
- Se o seu programa produz resultados diferentes dos esperados, você deixou bem claro o que esperava, por que esperava e os resultados atuais?
- Se sua pergunta estiver relacionada a algo específico de um local (idiomas, fusos horários), você forneceu as informações relevantes sobre seu sistema (por exemplo, seu fuso horário atual)?
- Você verificou se sua pergunta parece razoável em termos de formatação?
- Você verificou a ortografia e a gramática da melhor maneira possível? 4
- Você leu toda a questão para si mesmo com atenção, para ter certeza de que faz sentido e contém informações suficientes para que qualquer um que a leia consiga entendê-la, sem ter qualquer contexto que você já tenha?
Se a resposta a qualquer uma dessas perguntas for "não", você deve reservar um tempo para corrigir sua pergunta antes de publicá-la, passando por esta lista. Sei que pode parecer muito esforço, mas ajudará você a obter uma resposta útil o mais rápido possível; e você pode até resolver seu problema sozinho no processo! 5
Não se esqueça de que você está basicamente pedindo a outras pessoas que o ajudem pela bondade de seus corações - cabe a você fazer tudo o que puder para tornar isso o mais simples possível.
1 Se você passou de "algo que não está funcionando" para "fazendo uma pergunta" em menos de 10 minutos, provavelmente não pesquisou o suficiente. Isso deve incluir coisas como pesquisas normais na web (por exemplo, por uma mensagem de erro que você está recebendo), verificação da documentação, depuração (especialmente para exceções) e pesquisa no próprio Stack Overflow por questões semelhantes.
2 O ideal é que qualquer pessoa que responda à pergunta seja capaz de copiar seu código, colá-lo em um editor de texto, compilá-lo, executá-lo e observar o problema. Aplicativos de console são bons para isso - a menos que sua pergunta seja diretamente sobre um aspecto da interface do usuário, prefira escrever um aplicativo de console curto. Remova tudo o que não estiver diretamente relacionado à sua pergunta, mas mantenha-o completo o suficiente para ser executado - um Exemplo Mínimo, Completo e Verificável.
3 Tente evitar códigos que fazem os usuários rolar a tela horizontalmente. Talvez você precise mudar a forma como as quebras de linhas são feitas na sua IDE. Reserve um tempo para deixar isso o mais claro possível para aqueles que estão tentando ajudá-lo.
4 Não estamos procurando perfeição - apenas algum esforço. Se você sabe que seu português não é bom ou não conhece muito bem o jargão profissional de TI, veja se um colega ou amigo pode ajudá-lo com sua pergunta antes de postá-la.
5 Mais ou menos como descrito em Como debugar programas pequenos
Se sua pergunta inclui código, você o escreveu como um programa curto, mas completo?
, acho que dizer apenas "programa curto" nem sempre é claro (entendo que é quase uma tradução), acho que poderia ser o segundo item e talvez melhorado o texto dele.Se sua pergunta inclui código, você o escreveu como um fragmento que reproduza o erro?
*
no item "Se o seu programa produz resultados diferentes dos esperados, você declarou o que esperava, por que * esperava e os resultados reais?"? Nesse mesmo item acredito que "atuais" é melhor "reais". @GuilhermeNascimento talvez "simplificado" em vez de "curto"?