Versión actual del artículo Cómo crear un ejemplo mínimo, completo y verificable.
Cuando preguntas sobre un problema causado por tu código, recibirás mejores respuestas si proporcionas el código necesario para reproducir el problema. Ese código debe de ser:
- …Mínimo - usa la menor cantidad posible de código para reproducir el problema
- …Completo - asegúrate de proporcionar todas las partes necesarias para reproducir el problema
- …Verificable - prueba el código que aportas para asegurarte de que sirve para reproducir el problema
Mínimo
Cuanto más código haya, menos probable será que la gente encuentre el problema. Optimiza tu ejemplo de una de estas formas:
- Vuelve a empezar de cero. Crea un nuevo programa, agregando solamente lo que es necesario para ver el problema. Esto tiende a ser más rápido en sistemas vastos donde ya conoces la fuente del problema. También es útil si no puedes publicar el código original por razones legales o éticas.
- Divide y conquista. Cuando tienes un poco de código pero el motivo del problema no es claro, empieza a quitar un poco de código a la vez hasta que el problema desaparezca - entonces añade la ultima parte de nuevo.
Mínimo y legible
Mínimo no implica breve - no sacrifiques la comunicación por motivos de brevedad. Sé consistente con los nombres y el formato. No olvides tampoco incluir comentarios si necesitas explicar partes del código. La mayoría de editores de código tienen atajos para formatear - ¡encuéntralos y usalos! Además, no uses tabuladores - se ven bien en tu editor pero no en Stack Overflow. Aquí, crean un desastre.
Completo
Asegúrate de que toda la información necesaria para reproducir el problema está incluida.
- Algunos estarán listos para cargar las partes e intentar probar el código antes de aportar sus respuestas o sugerencias.
- El problema puede que no esté en la parte que te imaginas, sino que puede estar escondido en otra parte.
Si el problema requiere código del lado de los servidores y archivos de configuraciones XML, inclúyelos también. Si la página web requiere HTML, JavaScript y CSS, incluye lo necesario.
Verificable
Para poder ayudar a solucionar tu problema, la gente deberá saber que existe:
- Describe el problema. “No me funciona“ no es una explicación útil. Dinos cuál debería ser el comportamiento esperado. Cuéntanos cuál es la redacción exacta del error que se produce y en qué linea se está produciendo. Pon un resumen breve del problema en el título de la pregunta.
- Elimina todas las cuestiones no necesarias al problema. Si tu pregunta no es acerca de un error de compilación, asegúrate de que no haya errores de ese tipo. Usa un programa como JSLint para validar lenguajes interpretados. Todo el HTML y XML debe ser verificado.
- ¡Asegúrate de que el ejemplo reporta el problema en la actualidad! Si solucionaste el problema inadvertidamente mientras preparas el aporte pero no lo pruebas de nuevo, sería bueno saberlo antes de pedir ayuda.
Para mas ayuda en como depurar tu programa para crear un ejemplo mínimo, Eric Lippert tiene un muy buen articulo de blog sobre este tema: How to debug small programs en inglés.