├── LICENSE └── README.md /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2021 Guru-BR 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Como fazer uma boa pergunta? 2 | 3 | Entender como fazer uma boa pergunta é essencial: o melhor jeito de receber uma 4 | boa resposta é fazendo uma boa pergunta. Esse guia vai te ajudar nisso! 5 | 6 | ## Não peça para perguntar. Apenas pergunte. 7 | 8 | Evite perguntas como 9 | 10 | > Alguém aqui manja de Postgres? 11 | 12 | ou 13 | 14 | > Alguém pode me ajudar? 15 | 16 | Basta postar sua dúvida. Quem souber vai te ajudar, pode ficar tranquilo(a). Não 17 | se preocupe, você não vai soar rude. 18 | 19 | **Leitura recomendada:** https://dontasktoask.com/ 20 | 21 | ## Descreva _o que_ está tentando fazer, não _como_ está fazendo 22 | 23 | Por vezes confundimos o problema que estamos tentando resolver com a solução que 24 | estamos desenvolvendo. Ao postar sua dúvida, priorize sempre descrever o problema 25 | que está tratando, não sua solução atual. 26 | 27 | **Leitura recomendada:** https://xyproblem.info/ 28 | 29 | ## Não seja vago(a) 30 | 31 | Evite descrições vagas como 32 | 33 | > "Não funciona" 34 | 35 | ou 36 | 37 | > "Dá um erro" 38 | 39 | Essas frases carregam pouca informação para quem está tentando te ajudar. Seja 40 | claro sobre o que aconteceu: 41 | 42 | > "Quando eu tento buscar um usuário, o Active Record lança a exceção 43 | > ActiveRecord::RecordNotFound" 44 | 45 | ## Contextualize 46 | 47 | Onde o erro aconteceu? Sempre que possível inclua o trecho de código em questão 48 | e o backtrace/log de erros. Previlegie serviços como o https://gist.github.com/ ou o 49 | https://pastebin.ubuntu.com/. 50 | 51 | **OBS.:** Independentemente de como você compartilhe o seu código, é sembre bom 52 | lembrar: **este grupo é publico e o conteúdo pode ser lido por qualquer pessoa na 53 | internet**. Não envie dados sigilosos ou informações pessoais, principalmente de 54 | seus usuários, junto com a sua dúvida. 55 | 56 | ## Não suma! 57 | 58 | Ao postar sua questão, fique atento às respostas e possíveis dúvidas que possam 59 | surgir. Demorar muito tempo para responder pode desestimular usuários a te 60 | ajudarem no futuro. 61 | 62 | ## Quer aprender mais? 63 | 64 | Alguns links úteis: 65 | 66 | - https://stackoverflow.com/help/how-to-ask 67 | - http://catb.org/~esr/faqs/smart-questions.html 68 | --------------------------------------------------------------------------------