2.7. Trucs et astuces¶
Cette section fournit des astuces et les bonnes pratiques pour Bugzilla qui ont été développées.
2.7.1. Hyperlien automatique¶
Les commentaires dans Bugzilla sont en texte brut : saisir <U> produira
<, U, > plutôt que du texte souligné.
Cependant, Bugzilla fera automatiquement des hyperliens pour certaines parties du texte des commentaires.
Par exemple, le texte
http://www.bugzilla.org
sera transformé en hyperlien :
http://www.bugzilla.org.
D'autres chaînes peuvent être transformées en lien :
- bogue 12345
- bogues 123, 456, 789
- commentaire 7
- commentaires 1, 2, 3, 4
- bogue 23456, commentaire 53
- attachment 4321
- mailto:georges@exemple.com
- georges@exemple.com
- ftp://ftp.mozilla.org
- La plupart des autres types d'URL
Le corollaire ici, c'est que si vous saisissez un numéro de bogue dans un commentaire,
vous devez mettre le mot bogue
devant pour qu'il soit transformé en hyperlien
pour la commodité des autres.
2.7.2. Commentaires¶
Si vous changez les champs d'un bogue, ne faites de commentaire que si vous avez
quelque chose de pertinent à dire ou que Bugzilla impose que vous le fassiez.
Dans le cas contraire, vous spammeriez les gens inutilement avec des courriels de bogues.
Pour prendre un exemple : un utilisateur peut définir ses préférences pour filtrer les messages
pour ne pas recevoir de courriel quand quelqu'un s'ajoute dans la liste Copie à
d'un bogue
(ce qui arrive souvent). Si vous vous ajoutez à la liste Copie à
et que vous ajoutez un
commentaire disant Je m'ajoute dans la liste Copie à
, alors cette personne recevra un
courriel sans intérêt qu'elle n'aurait pas reçu autrement.
N'utilisez pas de signature dans les commentaires. Signer avec votre prénom (Jean
) est acceptable,
si vous le faites par la force de l'habitude, mais des signatures complètes de style courriel ou liste
de diffusion avec quatre lignes d'ASCII art
ne le sont pas.
Si vous pensez qu'un bogue que vous avez rapporté a été incorrectement marqué comme DOUBLON d'un autre, veuillez l'indiquer dans votre bogue, pas dans celui dont il est le doublon. Vous pouvez mettre en copie la personne ayant marqué votre bogue comme étant un doublon si celle-ci n'est pas déjà en copie.
2.7.2.1. Markdown¶
Markdown est un format de texte brut structuré qui permet d'écrire des commentaires ayant avec une mise en forme. Par exemple, vous pouvez utiliser Markdown pour mettre en italiques ou en gras une partie de votre commentaire dans le html généré. Bugzilla gère la plupart des structures définies dans le standard Markdown, mais ne gère pas les images et le HTML intégré (inline). Pour une référence complète des structures Markdown gérées, veuillez consulter le lien sur l'aide sur la syntaxe à côté de la case à cocher Markdown pour les nouveaux commentaires.
Pour utiliser la fonctionnalité Markdown, assurez-vous que le paramètre Activer la gestion de Markdown pour les commentaires soit défini à on dans vos Préférences utilisateur et que vous avez coché l'option Utiliser Markdown pour ce commentaire sous la boîte de commentaire quand vous voulez soumettre un nouveau commentaire en utilisant Markdown.