23

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

Retorne para o índice da FAQ

15
  • 1
    Todos itens do tópico no post são importantes no geral, mas esse aqui é o problema mais comum do site 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.
    – Syzoth Mod
    Commented 12/11/2020 às 21:50
  • @GuilhermeNascimento, e for assim: Se sua pergunta inclui código, você o escreveu como um fragmento que reproduza o erro? Commented 12/11/2020 às 21:55
  • 1
    Pois é, esse é meu medo, raramente as pessoas entendem o que é um exemplo minimo, sem as partes desnecessárias e não relacionadas a falha, acho que alguns dos tópicos aqui no post deveria ser links, além de melhorar um pouco para pessoas pouco familiarizadas com certas palavras, até entendo o que é fragmento, no contexto, mas para quem lê de fora pensa q é só tirar um pedaço e colar na pergunta. Vou tentar pensar em um texto curto e simples para esse item do tópico.
    – Syzoth Mod
    Commented 12/11/2020 às 21:56
  • 2
    "Saída esperada e saída atual" é algo que agrega muito ao post, é literalmente "uma olhada" e o leitor entende o problema, mas mesmo assim muita gente vacila nisso Commented 12/11/2020 às 22:30
  • 1
    Qual o significa do * 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"?
    – Costamilam
    Commented 12/11/2020 às 22:48
  • 1
    @RafaelTavares não digo sempre, mas algumas vezes só de comparar a saída com o esperado vem a solução de uma vez. Commented 12/11/2020 às 22:49
  • @Costamilam eu pretendia dividir o tópico e na hora me pareceu uma boa ideia dar atenção a outra coisa e acabei esquecendo o * no meio da frase. Já foi corrigido. Commented 12/11/2020 às 22:51
  • @Costamilam curto no sentido de mais curto possivel, ainda sim que seja claro, não é bem a questão de ser simples, mas sim a melhor maneira de se explicar esse paragrafo para quem esta começando a "aprender perguntar"
    – Syzoth Mod
    Commented 13/11/2020 às 0:34
  • 1
    @Augusto Vasques, parabéns pela iniciativa. Muito boa sua postagem.
    – Solkarped
    Commented 13/11/2020 às 17:12
  • @Solkarped, obrigado. Se tiver alguma sugestão é só editar. Commented 13/11/2020 às 17:28
  • 4
    Uma coisa legal disso é que as pessoas podem ver que o que queremos não é algo inventado pelo SOpt, se no SOen aceitam bagunça é só porque não tem gente ligando mais. Se alguém acha que o Jon Skeet está errado tenho zero respeito pela opinião dessa pessoa.
    – Maniero Mod
    Commented 15/11/2020 às 17:24
  • 1
    uma sugestão pegando um gancho no comentário do @GuilhermeNascimento, podemos incluir ai um link para uma pergunta bem formatda, com codigo no snippet por exemplo? talvez isso ajude a entender o que queremos dizer com "exemplo minimo e verificável" Commented 23/05/2021 às 23:26
  • @RicardoPontual tem alguma sugestão em mente? Commented 23/05/2021 às 23:38
  • 1
    como o snippet funciona com html/css/javascript, pesquisei as perguntas com mais pontuação com essas tags, as primeiras que aparecem com snippet nas perguntas são essas: pt.stackoverflow.com/q/81728/57220 e pt.stackoverflow.com/q/6770/57220, e seguindo a ordem de pontuação, as primeiras que vi com respostas com snippets, que também serviriam como referência foram essas: pt.stackoverflow.com/q/37313/57220 e pt.stackoverflow.com/q/2817/57220 qualquer uma delas serviria como referência Commented 23/05/2021 às 23:51
  • 1
    @RicardoPontual não creio que irá resolver, porque as pessoas infelizmente chegam aqui as pressas e ao mesmo tempo "com preguiça", fora que HTML, CSS e JS são apenas alguns casos, temos muitos hibridos que dependem de muita coisa para funcionar bem dentro do StackSnippet, o que torna muito dificil para o usuário, o que a pessoa tem que entender é como fazer uma versão sem toda a parte desnecessária e ainda sim ocorra exatamente o mesmo erro ou funcionamento desejado para que a pergunta se torne compreensivel.
    – Syzoth Mod
    Commented 24/05/2021 às 0:02

0

Você deve fazer log-in para responder a esta pergunta.

Pesquise outras perguntas com a tag .