Rapporter un bug (Mageia Bugzilla)

Table des matières

La langue utilisée est l'Anglais, donc abstenez vous d'écrire en français, trois phrases simples et précise sont mieux qu'un long discours, ainsi le recourt au traducteur en ligne est une bonne options. Les canaux IRC ou encore le forums peuvent également être une source d'aide si besoin.

Définition

Que ce qu'un bug ? Un bug est l'expression utilisée pour décrire une erreur, un incident, défaut ou encore irrégularité.

Mais les bugs ne sont pas restreints aux logicielles. Il peuvent être partout, dans les applications, les éléments matériels, les personnes.

Donc basiquement, si un problème est reproductible, dans la documentation, la traduction, le graphisme, le site web, l'infrastructure ou bien encore dans le projet Mageia.Org, de ses contributeurs ou équipes de travail, il peut être reporté en tant que bug.

Les demandes de paquets sont également considéré comme un bug. Voir vers la fin

Règles

• Soyez précis
• Soyez clair, expliquez de façon que les autres puissent reproduire le bug
• Une seul bug par rapport de bug
• Aucun bug n'est trop trivial pour être reporter, les petits peuvent en cacher de gros.
• Faites la distinctions entres les faits et les spéculations
• Toujours lancer les applications avec le préfixe 'LC_ALL=C' qui vous permet de les exécuter en anglais facilitant donc le dialogue entre tous les protagonistes.
  
  

exemple :

Préliminaires

• Dans la mesure de possible essayé de reproduire le bug avec une version plus a jour de l'application en question
• Allez sur la page de recherche pour voir si votre erreur est déjà connu
• En utilisant le préfixe ALL pour le premier terme de la recherche, bugzilla cherchera aussi dans les bugs fermés (mais pas forcement résolu)
• Si "votre" bug est dans la liste, vous pouvez laissé un commentaire, voire même rajouter des infos demandé si vous pouvez les fournir.
• N'hésitez pas a demander de l'aide sur les forums sur les canaux IRCs.
  
  

Rapporter un nouveau bug

(Les éléments qui suivent sont pour les bugs dans la distributions, pour ce qui est de l'infrastructure ou des site Web la même démarche qui suit est valable, c'est accessible ici)

• Connecter vous sur le bugzilla avec votre identifiant mageia, si vous n'en n'avez pas c'est par ici
  
  ***note*** (attention le bugzilla permet de voire les adresse email en clair pour les utilisateurs logues et dans les archives des actions du bugzilla, non indexer par les moteurs de recherche)
• Puis allez vers "File a bug" et choisissez Mageia
• Puis vient le choix de différents champs:
  
  

Component

Correspond a la sous rubrique du produit "Mageia"

• "Installer" correspond au bug relatif à l'installateur classique présent sur les isos DVD ou dual (non live)
• "New rpm package request" pour les demandes de paquets voir plus bas ***lien***
• "RPM Packages" Bug relatif a tous les paquets, si vous ne savez pas quel choix prendre utilisez celui-ci.
• "Release (media or process) pour les aspect technique ou politique relatif à la distribution Mageia
• "Security" pour tout ce qui est du domaine de la sécurité et critique au sein de la distribution.
  
  

Version

Dans quelle version de la distribution ce situe le bug ?

1 pour Mageia 1 (version stable actuel), Cauldron la version de développement (future Mageia 2)

Hardware Platform

Sur quelle architecture reproduisez vous le bug ?

i586 est pour 32bits, x86_64 est pour la 64bits, arm est pour ***lien wiki***, et all est pour tous.

Source RPM

Il s'agit du RPM correspondant a l'endroit ou ce trouve l'erreur.

Par exemple, si vous savez que le problème ce situe dans le deamon mysqld, executé ainsi "rpm -qif /usr/sbin/mysqld". Cela vous donnera le nom et la version du rpm est question. ce que nous cherchons pour le rapport de bug est le champs SOURCE RPM, qui est ici MySQL-5.0.27-1mga1.src.rpm.

Alternativement vous pouvez utilisez "rpm -qf /usr/sbin/mysqld --qf '%{SOURCERPM}\n" pour obtenir la même information.

Si vous ne connaissez pas l'emplacement de la source du problème "rpm -qf `which mysqld`" est également un moyen. Dans tous les cas l'équipe de triage du bugzilla reste présent si quelque chose est incomplet.

URL

Cela peut être un lien qui montre le problème ou une discussion relatif a celui-ci sur un forum, un rapport de bug upstream - en amont (chez le projet en lui même), ou dans une autre distribution.

Summary

Le résumé de votre bug.

Un bon résumé est quelque chose qui décrit le problème avec des mots clé précis et clair, tout le reste est inutile comme par ex: "please... in my mageia 2 take from yesterday"



*Quelques mauvais exemples

mail crashed

Software crashe



*leurs équivalent bon

crash in Evolution while checking for new POP mail

Cancelling a File Copy dialog crashes File Manager

Details

C'est ici que ce retrouverons tous les détails de votre rapport de bug, notamment:

Description of problem

Description plus complète que le résumé, soyez le plus précis et clair en décrivant votre problème tout en restant conci



*<span style="color:#c00;font-weight:bold;">Bad example:</span> I can't seem to login to the system. Please help!



*<span style="color:#0c0;font-weight:bold;">Good example:</span> I'm unable to login to the system via ssh. The /var/log/messages log indicates there is a problem with the pam module pam_ldap, but the /etc/pam.d/system-auth file doesn't contain that module and I'm not using LDAP. I looked at /etc/pam.d/sshd and it does contain that module but I'm not sure how it got there, unless it was due to the super-spiffy super-ldap-mojo package I installed yesterday.

Version-Release number of selected component (if applicable):

packet(s) mis en cause dans le rapport de bug (si possible)

ex: openldap-2.3.34-5mga1, pam-0.99.7.1-2mga1

How reproducible:

Frequence de la reproduction du bug



ex: Every time I attempt to login.

Steps to Reproduce:

Étape nécessaire afin de reproduire le bug. Veillez inclure tout ce qui peut-être spécifique a votre cas.





# ssh user@host

# see the rejection



Si vous avez un logiciel qui 'crash' l'utilisation de GDB ***lien*** en plus de lancer le logiciel en console peut aider dans la résolution.

(Sinon pour la suite les mainteneurs/développeur ou équipe de triage peuvent vous demandé plus d'information si besoin.)

Attachment

Si vous avez besoin de reporté une capture d'écran ou des logs de votre problème l'utilisation des fichiers attachés est plus encouragé. D'autant plus que des lien vers des plateformes externe pour l'hébergement de photo ou de texte arrivent souvent à expiration après un certain.

Dans tout les cas, si vous avez des logs long, dans un premier temps supprimé les choses qui vous paraissent inutile (42 de fois la même ligne) et puis sinon ajouté un fichier joints.

Assigne

Si vous connaissez la personne qui s'occupe du problème vous pouvez ajouté son adresse email, sinon laisse le champs vide, ce sera donc l'équipe du bugzilla qui ce chargera de cela en cas de besoin.

Verfication

Vérifier que l'ensemble vous semble complet puis clicker sur "commit".

Votre bug est maintenant dans la base du bugzilla.

Soyez attentif a email de sa part que vous recevez, il s'agira des actions faite sur votre bug.

Pour repondre a une demande, il vous faudra à nouveau passé par l'interface Web, et non pas envoyé d'email privé vers la personne (sauf explicitement demandé)





[1], [2]: <code>rpm -qi package</code> will give you a lot of information about a package.

Comment faire une demande paquets

Afin d'avoir une liste cohérente ), merci de bien respecter les indications suivantes:

• Pour le résumé utiliser la forme: <nom_de_l_application>, <bref_description>par exemple vagrant, a tool to build virtualized environments with VirtualBox
• Sélectionner la catégorie "New RPM package request" ( Component field)
• Ajuster la sévérité à "enhancement" (severity)
• Ajouter un lien vers la page du projet dans le champs "URL"
  
  

Article traduit en partir de la page sur le wiki anglais