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 proveesproporcionas el código que se puede usarnecesario 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 - asegurateasegúrate de proveerproporcionar todas las partes necesarias para reproducir el problema
- …Verificable - prueba el código que aportas para asegurarte de que reproducesirve 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 la razónel motivo del problema no esta claraes claro, empieza a removerquitar un poco de código a la vez hasta que el problema desaparecedesaparezca - 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. Usa nombramientos y hendiduras consistentes Sé consistente con los nombres y no se te olvideel formato. No olvides tampoco incluir comentarios si necesitas explicar partes del código. La mayoría de los editores de código tienen atajos para formatear - ¡encuéntralos y usalos! Por igualAdemás, no uses tabstabuladores - estos se ven bien en tu editor pero no en Stack Overflow. Aquí, crean un desastre.
Completo
AseguraseAsegúrate de que toda la información necesaria para reproducir el problema esta incluidoestá 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 esteesté en la parte que te imaginas pero en vez se esconda, 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, JavascriptJavaScript y CSS, incluye lo necesario.
Verificable
Para poder ayudar a solucionar tu problema, otros deberánla gente deberá saber que existe:
- Describe el problema. “No me funciona“ no es una declaraciónexplicación útil. Dinos cuál debería ser el comportamiento esperado. Cuéntanos cualcuá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 tula 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.