Ejemplos mínimos
¿Por qué crearlos?
- Cuanto más simple es el ejemplo, más rápidamente pueden los desarrolladores entenderlo y ayudarle.
- Un ejemplo simple demuestra que se ha esforzado en resolver el problema por sí mismo. Cuando alguien envía bloques grandes de código de entrada, da la impresión de que no le importa que le ayudemos o que no.
- La creación de un ejemplo mínimo le fuerza a entender lo que está ocurriendo. Muchos informes falsos de problemas se podrían evitar intentando crear un ejemplo mínimo; si no puede reproducir un “bug” en un ejemplo mínimo, probablemente el problema era una comprensión insuficiente sobre LilyPond, ¡no un verdadero bug!
¿Cómo los hago?
-
Incluya el número de versión en una instrucción
\version. - ¡Hágalo muy pequeño! Los ejemplos relacionados con el espaciado o la disposición de las páginas pueden requerir muchos compases, pero casi todos los problemas se pueden reproducir mediante un solo compás.
-
Cuando trate de crear un ejemplo, pruebe a convertir en comentarios
(
%ó%{ … %}) distintas secciones del archivo. Si puede convertir un bloque en un comentario y aún mostrar la idea principal, entonces ¡elimine ese bloque! - Evite la utilización de notas, tonalidades o compases muy complicados, a no ser que el bug esté relacionado con el comportamiento de esos elementos.
-
No utilice instrucciones
\overrideni\seta no ser que el bug se refiera a esas instrucciones en particular.
Otros idiomas: English, deutsch, français, magyar, italiano, nederlands.