Esta tradução acabou sendo adotada oficialmente na Central e ajuda, com pequenas alterações. Acesse: https://pt.stackoverflow.com/help/mcve
Como criar um exemplo Mínimo, Completo e Verificável
Ao perguntar sobre um problema no seu código, você conseguirá melhores respostas se der às pessoas código que elas possam usar para reproduzir o problema. Esse código deve ser…
- …Mínimo – Use o mínimo possível de código capaz de reproduzir o problema
- …Completo – Forneça todas as partes necessárias para se reproduzir o problema
- …Verificável - Teste o código antes de postar para confirmar que ele reproduz o problema
Mínimo
Quanto maior o código, menor a chance de alguém enxergar o problema. Simplifique seu exemplo usando uma destas técnicas:
Recomece do zero. Crie um novo programa, e só inclua nele o necessário para reproduzir o problema. Isso pode ser mais rápido para grandes sistemas, quando você acredita saber a origem do problema. Também é útil se não puder postar o código em público por razões legais ou éticas.
Dividir e conquistar. Se o código for pequeno, mas você não tem ideia da causa do problema, comece a remover um pedaço de código por vez até que o problema suma – e então inclua essa última parte de volta.
Mínimo e legível
Mínimo não quer dizer necessariamente o mais curto possível – um exemplo claro é melhor que um exemplo pequeno. Use nomes e indentação consistentes, e se necessário inclua comentários para explicar partes do código. Praticamente todos os editores de código têm um um comando de autoformatação – encontre e use! E não use tabs – elas podem aparecer bem no seu editor, mas no Stack Overflow podem sair bagunçadas.
Completo
Certifique-se de incluir toda a informação necessária para reproduzir o problema:
Algumas pessoas vão querer testar a resposta antes de postar.
O problema às vezes não está onde você pensa, mas em outra parte do código.
Se o problema requer código server-side ou um arquivo de configuração XML, inclua ambos. Se um problema num site requer HTML, JavaScript e CSS, inclua os três.
Verificável
Para ajudá-lo a resolver seu problema, as pessoas primeiro precisam comprovar que ele existe:
Elimine qualquer aspecto que não seja relevante para a pergunta. Se a pergunta não for sobre um erro de compilação, garanta que não haja nenhum erro desse tipo. Use ferramentas como o JSLint para validar linguagens interpretadas. Sempre valide o HTML ou XML.
Garanta que o exemplo realmente reproduza o problema! Se você resolveu o problema por acaso enquanto criava o exemplo mas não testou de novo, pode não perceber que o código que está postando não ajuda.
Em certos casos ajuda desligar e reiniciar o sistema, ou testar o exemplo em outra máquina para confirmar que de fato esteja entregando um exemplo válido do problema.
Para mais informações sobre como depurar seu programa para criar um exemplo mínimo, o Eric Lippert criou um blog post incrível sobre o assunto: How to debug small programs (en). Veja em português: Como debugar programas pequenos.