Comment signaler un bug ?

Pourquoi ?

Vous rencontrez un problème à l'installation ou à l'utilisation de Ganesha. Evidemment, cela est toujours un peu frustrant et vous êtes peut être tenté d'envoyer directement un mail au développeur pour lui dire "Ca ne marche pas !".
Cependant, sachez que ce n'est pas le moyen le plus rapide ou le plus efficace d'obtenir une réponse.

Une question mal formulée va obliger la personne qui vous répond à vous poser question sur question, ce qui risque d'allonger grandement le délai de résolution de votre problème. De plus, gardez à l'esprit que les réponses et le temps passé à les rédiger sont bénévoles et sans contrepartie, et que votre problème, s'il est mal explicité, risque de ne pas "attirer" de réponses et donc de rester irrésolu.

Les 7 commandements

Soyez précis : "Ca ne marche pas" ou "Je n'arrive pas à me connecter" ne signifient rien pour le développeur.

Soyez décriptif, voire prolixe : "Quand je clique, j'ai un message d'erreur !" n'est pas très descriptif. Par contre :

Lorsque, en tant que stagiaire, je clique sur 'Ecrire un nouveau message', la page suivante affiche le message d'erreur suivant :
"Not Found
The requested URL /ganesha/stagiaire/index.php was not found on this server."
Et rien d'autre ne saffiche.

Ce message est beaucoup plus clair pour le développeur !

N'hésitez pas à en dire trop que pas assez : le développeur pourra toujours faire le tri. Dites notamment où vous étiez, et ce que vous avez fait.

Utilisez le forum : c'est le meilleur endroit pour signaler un problème : beaucoup de gens le fréquente (=plus de possibilités de réponses), il permet aussi d'avoir un historique des réponses données (= aider d'autres utilisateurs ayant le même problème), ainsi que les solutions trouvées (= base de connaissances). Rappel de l'adresse : http://www.anemalab.org/phorum/list.php?f=2. N'envoyez pas de mails directement à la personne : la réponse ne profitera pas au reste de la communauté, et vous pouvez attendre longtemps la réponse.

Utilisez la Foire Aux Questions : votre question a peut être déjà été posée (et votre problème résolu), n'hésitez donc pas à fouiller dans la FAQ (disponible sur http://ganesha.keonox.com/faqg/) et usez et abusez le la fonction de recherche du forum.

Décrivez votre configuration : il existe différentes version de Ganesha, fonctionnant sur différentes plateforme. Vous gagnerez beaucoup de temps (des jours ?) en indiquant quelques informations de bases (cf plus bas).

Soyez poli : ça ne coûte rien et c'est plus agréable pour tout le monde. Rappel : ceux qui vous aident le font bénévolement et par plaisir, pas par devoir ou par profit, vous ne pouvez donc pas exiger d'eux d'être plus efficace qu'une hotline à 3€/mn.

Suivez votre problème : n'hésitez pas à relancer votre problème sur le forum au bout de quelques jours sans réponses, peut être votre message est-il passé inapperçu ? Surtout, fermez le sujet en indiquant si votre problème à été résolu et comment.

Comment bien décrire mon problème ?

Le plus souvent il s'agit de faire un bon vieux "QQQOCP" :

Toutes ces questions ne s'appliquent pas toujours. Par contre, il est important préciser au maximum votre configuration :

• Version de Ganesha : indiqué sur la page d'accueil (ex: "1.3RC1", "2.0beta4")
• Type d'hébergement : "Hébergé chez OVH", "Hebergement gratuit Free.fr" ou "Ganesha installé en local sur WindowsXP avec EasyPHP 1.7", par exemple
• Adresse du site : http://www.e-carel.org/, par exemple (vous n'êtes pas obligé, mais ça peut grandement aider !)
• Adresse et paramêtre de la page d'erreur : http://www.e-carel.org/ganesha/stagiaire.php?connexion=4357311&menu=0 par exemple. Pour obtenir cette information, faites un clic-droit sur la page où survient l'erreur, puis cliquez sur "Propriétés" et séléctionnez l'URL (clic-gauche) puis clic-droit => "Copier" avant de la coller dans le forum. Cette information est parfois très utile.

Enfin, il vous sera peut-être demandé des informations sur votre configuration logicielle (PHP ou apache). Pour cela, il faut obtenir un "phpinfo", c'est à dire l'ensemble des paramètres de configuration logiciel.

Si on vous demande un "phpinfo" :

* Si vous utilisez EasyPHP, faites un clic-droit sur l'icone d'EasyPHP ("e" avec le point rouge clignotant) et séléctionnez "Administration", vous avez alors un lien "PhpInfo".
* Si vous en êtes à la phase d'installation, à l'étape 2 vous pouvez cliquer sur le lien "aide" qui vous affichera les données.
* Si vous utilisez ganesha en production, appelez la page http://votresite.com/testconfig/ qui vous affichera aussi le tableau.
* Enfin si vous avez supprimé par sécurité ces deux dossiers (install et testconfig), vous pouvez toujours faire votre phpinfo vous même :

1. créez un fichier test.txt vide.
2. écrivez dedans : <?php phpinfo(); ?>
3. sauvegardez et renommez le fichier en test.php
4. envoyez le en ligne (si nécéssaire)
5. appelez http://votresite.com/test.php

Voilà, avec tout ça, je suis persuadé que quelqu'un saura répondre rapidement à votre problème ;-)

Pierre-Yves

PS :

Exemple réél d'un message clair et bien rédigé

Bonjour,

Version & Configuration
Windows 2000
APPSERV-WIN32 2.3.0 Concurent de EASYPHP
Apache 1.3.29
PHP 4.3.5
MYSQL 4.0.16-nt
TEST en Local "Serveur = Localhost - Base = ganesha"

J'ai installé GANESHA Version 1.2.1
au lancement j'ai un certaine nombre d'erreur :
C:\AppServ\www\ganesha\ganesha\php\inc\c_formation.inc.php on line 129
C:\AppServ\www\ganesha\ganesha\php\inc\c_formation.inc.php on line 129
C:\AppServ\www\ganesha\ganesha\php\inc\c_formation.inc.php on line 130
C:\AppServ\www\ganesha\ganesha\php\inc\c_formation.inc.php on line 130
C:\AppServ\www\ganesha\ganesha\php\inc\c_formation.inc.php on line 147
C:\AppServ\www\ganesha\ganesha\php\inc\c_groupe.inc.php on line 173
C:\AppServ\www\ganesha\ganesha\php\inc\c_groupe.inc.php on line 176
C:\AppServ\www\ganesha\ganesha\php\inc\c_webmail.inc.php on line 545
C:\AppServ\www\ganesha\ganesha\php\inc\c_webmail.inc.php on line 545
C:\AppServ\www\ganesha\ganesha\php\inc\c_webmail.inc.php on line 637
C:\AppServ\www\ganesha\ganesha\php\inc\c_webmail.inc.php on line 637
C:\AppServ\www\ganesha\ganesha\php\inc\c_webmail.inc.php on line 673
C:\AppServ\www\ganesha\ganesha\php\inc\c_webmail.inc.php on line 673
C:\AppServ\www\ganesha\ganesha\php\inc\c_webmail.inc.php on line 673
Etc.......... le message suivante sur une 100 de lignes

Warning: Call-time pass-by-reference has been deprecated - argument passed by value; If you would like to pass it by reference, modify the declaration of [runtime function name](). If you would like to enable call-time pass-by-reference, you can set allow_call_time_pass_reference to true in your INI file. However, future versions may not support this any longer.

Voir la configuration ci-dessus.
Si quelqu'un à la solution merci d'avance

Cordialement
A+

Exemple d'un message peu clair (mais poli ;)) :

Bonjour a tous,

Dans l'instalation sur local , dans la step3 -Can't open database.
MySql est active.
J'ai dans local web et ganesha 1.3 mais les noms des bases de donnes sont different.

Ou j'ai faut?

Merci

Vous je ne sais pas, mais moi ça ne motive pas pour répondre :-)