Rapporter un bug (Mageia Bugzilla)

Cette page va vous aider a comprendre ce qu'est un bug, quand et comment il doivent être rapporter et à quoi faire attention. Un rapport de bug soigné permet une bonne résolution. Les étapes sont là pour vous expliquer comment écrire de bon rapports.
'''Note''' 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 reproduisible, 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.
*** lien vers la fin*** Les demandes de paquets sont également considéré comme un bug.


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.
ex LC_ALL=C urpmi --debug vlc


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 https://bugs.mageia.org/query.cgi 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 elements qui suivent sont pour les bugs dans la distributions, pour ce qui est de l'infrastruture ou des site web la même demarche qui suit est valable, c'est accessible ***https://bugs.mageia.org/enter_bug.cgi?format=guided&classification=__all *** ici)
*connecter vous sur le bugzilla ***lien***avec votre identifiant mageia, si vous n'en n'avez pas c'est par ici: ***lien identica***
***note*** (attention le bugzilla permet de voire les adresse email en claire 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 choissisez Mageia ***https://bugs.mageia.org/enter_bug.cgi?product=Mageia&format=guided**
*Puis vient le choix de differents champs:

*"Component" Qui correspond a la sous rebrique du produit "Mageia"
"Installer" coorespond au bug relatif à l'installateur classique present sur les isos DVD ou dual (non live)
"New rpm package package" 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 securité 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 developement (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" C'est le 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 connaisez pas l'emplacement du souce 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 imcomplet.

"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 resumé est quelque chose qui décrit le problème avec des mots clé précis et clair. Tout le reste est inutile comme 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:''' The details of your problem report, including:

'''Description of problem:''' More detailed restatement of summary. Expand on the Summary. Please be as specific as possible about what is wrong.

*<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):'''

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

'''How reproducible:'''

Every time I attempt to login.

'''Steps to Reproduce:''' Brief, easy-to-follow steps that will trigger the bug. Include any special setup steps.

# ssh user@host
# see the rejection


For crashing bugs:
Have a look at [[Debugging_software_crashes|Debugging software crashes]] to learn how to produce and provide the required debugging information (backtraces) in the case where software crashes or produces a segmentation fault (segfault)


* Add an Attachment if it can help (not all your logs, just the log of your issue)
You can look inside the [[Triage_guide#Special_cases_of_specific_information_required|Triage Guide]] to see whether more specific information is required for your bug report, which lessens the work of the triage team.
* Enter the email of the package maintainer^[2] in Assign To if you know it (or let triage team add it)


Double-check your report for errors and omissions, then press "Commit". Your bug report will now be in the Bugzilla database.

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

Parts of this page have been taken from https://landfill.bugzilla.org/bugzilla-3.6-branch/page.cgi?id=bug-writing.html



==Comment faire une demande paquets

Afin d'avoir une liste cohérente https://bugs.mageia.org/buglist.cgi?product=Mageia&component=New%20RPM%20package%20request&resolution=--- ), 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"

https://wiki.mageia.org/en/How_to_report_a_bug_properly