LilyPond – la notation musicale pour tous: Exemples minimaux

Exemples minimaux

Un exemple minimal est un bout de code duquel plus rien ne peut être retiré.

Au plus l’exemple est simpliste, au plus vite ceux qui pourraient vous aider comprendront votre propos et vous apporteront une réponse.
Réduire l’exemple à sa plus simple expression indique que vous avez déjà tenté par vous-même de trouver une solution. Des tonnes de lignes laissent à penser que celui qui les envoie se soucie peu de ce qui arrive.
La génération d’un exemple minimaliste permet de comprendre ce qui se passe et évite la plupart du temps de signaler un problème qui, en réalité, n’existe pas : lorsqu’un « bogue » ne peut être reproduit dans le cadre d’un exemple minimal, il y a de fortes présomptions qu’il s’agisse d’une inadéquation entre l’utilisateur et LilyPond plutôt que réellement d’un « bogue ».

Inclure une mention \version pour indiquer le numéro de version utilisée.
Être aussi bref et concis que possible. Si des problèmes concernant les espacements ou la mise en page peuvent nécessiter un certain nombre de mesures, la plupart des litiges peuvent se cantonner à une seule mesure.
Lorsque vous créez un exemple minimal à partir de votre code, commencez par commenter des portions de votre fichier – à l’aide de % ou %{ … %}. Tout ce que vous mettez en commentaire et qui ne nuit pas à la démonstration est superflu ; suprimez-le !
Évitez autant que faire se peut toute notation, tonalité ou métrique complexe, à moins que leur traitement ne soit précisément l’objet du litige.
N’utilisez pas les commandes \override ou \set à moins que le problème ne soit directement lié à leur utilisation.