Se você já se viu diante de um problema de código ou teve dúvidas sobre alguma tecnologia, mas não soube como formular a pergunta de maneira eficiente, este artigo é para você.
No twitter ou em grupos do Discord me deparo com perguntas que demandam tempo ou que são desgastantes para serem respondidas, e não é porque o problema é complexo ou algo do tipo, mas porque a pergunta é feita contendo pouca informação e de forma muito abrangente, dificultando uma resposta rápida e direta.
Sumário
O que deve ser comunicado?
Ao buscar ajuda, se coloque no lugar de quem vai analisar o seu problema. Antes de enviar qualquer mensagem pedindo auxílio, pergunte a si:
"O que a pessoa que está olhando meu problema precisa para me ajudar?"
Quem for olhar seu problema caiu de paraquedas e precisa entender a situação da melhor maneira possível para poder te ajudar.
Contextualize a situação:Antes de compartilhar seu código, forneça um contexto claro, fale do proposito do código e um pouco do que você está fazendo.Descreva suas tentativas e objetivos:Fale o que você já tentou para resolver o problema. Isso não apenas evita sugestões repetitivas, mas também mostra que você está se esforçando resolver o problema. Inclua detalhes sobre mensagens de erro específicas que você encontrou e qualquer ideia que tenha tido durante o processo.Capturas de Tela e Códigos Relevantes:Se o problema estiver relacionado a uma mensagem de erro, capture a tela dessa mensagem. Imagens podem oferecer uma visão instantânea do problema. Além disso, compartilhe pequenos blocos de código diretamente relacionados à questão. Isso simplifica a análise para quem está ajudando e aumenta a probabilidade de uma resposta eficaz.
Use carbon, gist ou codepen para compartilhar seu código de maneira limpa e organizada.
Evite tire fotos usando o celular, use alguma ferramenta de captura de tela.
Pesquise no Google
Isso pode ser um conselho muito obvio, mas vejo muita gente perguntando algo que com apenas uma pesquisa resolveria o problema dela.
Seu problema não é especial, provavelmente alguém já passou por ele e perguntou em algum lugar da internet. Pesquisar no Google não apenas economiza tempo. Além disso, ao explorar fóruns, comunidades online e sites, você pode descobrir soluções detalhadas para problemas comuns.
Tenha cuidado com sites e fóruns que tenham respostas antigas, provavelmente aquela solução esteja desatualizada.
É importante destacar que a documentação da linguagem, biblioteca ou framework que você está utilizando é a fonte primária de informações. Ler a documentação pode fornecer inspirações valiosos sobre funcionalidades, métodos e práticas recomendadas.
Portanto, antes de postar sua pergunta em um fórum ou comunidade, reserve um tempo para pesquisar no Google. Essa abordagem não apenas fortalecerá suas habilidades de resolução de problemas, mas também o conectará com a riqueza de conhecimento disponível na vasta rede de desenvolvedores.
Escrevendo perguntas
Agora vou te mostrar como perguntar de maneira mais eficiente, facilitando a sua vida e a vida do programador que vai te ajudar.
Não pergunte assim❌
Pergunte assim ✅
As perguntas acima foram feitas apenas para ilustrar o meu ponto.
Na maioria das vezes a primeira pergunta é ignorada ou então atrai pessoas que não vão conseguir solucionar seu problema. O que a pessoa perguntou, na verdade, aqui é:
Qualquer programador que esteja disposto a se comprometer a investigar meu problema, seja ele qual for, mesmo que não seja realmente relacionado a programação ou se alguém que não sabe nada sobre programação poderia realmente responder à minha pergunta?
Agora veja duas perguntas feitas em uma comunidade do Discord, você vai notar a diferença de resposta.
No segundo, um pequeno contexto do problema, a dúvida que a pessoa tinha e em seguida uma captura de tela do erro, dá para perceber que as pessoas já aparecem com diferentes soluções.
No primeiro, tem menos diálogo, e as pessoas precisam perguntar o contexto e o seu objetivo para tentar te ajudar, isso parece algo pequeno, mas demanda energia e disposição.
Referências
Conclusão
Esse é meu primeiro post no dev.to e espero ter ajudado alguém😁. Foi um processo interessante.
Top comments (4)
Assunto essencial e muito bem abordado, primo! Vai ajudar muita gente com esse problema e outros que não tem muita paciência com as perguntas pouco detalhadas.
Outro ponto que me deixa bastante irritado é quando a pessoa pede por ajuda (sem dar o contexto) e simplesmente some depois, sem falar sobre o problema.
Eu estava precisando dessa dose de conhecimento em como fazer perguntas e responder também 🤝Brabo!
Obrigado por compartilhar, primo