Coppermine Photo Gallery v1.5.x: Documentation et manuel

Table des matières

Tests de Coppermine

Cette section de la documentation a été crée alors que le pack était en phase alpha. elle est restée dans le pack et à été appliquée ainsi, jusqu'à ce que soit atteinte le stade bêta. Lorsque cpg1.5.3 est sorti en Release Candidate, cette partie de la documentation est restée à l'intérieur du pack car étant toujours valide. Enfin, quand cpg1.5.4 a été publié comme version stable le document tests est toujours resté, puisqu’il s’applique toujours en partie: cpg1.5.x est maintenant dans un état où il peut être recommandé pour une utilisation en production, mais il y a probablement encore beaucoup de bugs (c'est le cas pour tous les logiciels), donc si vous pensez que vous avez trouvé un véritable bug, s'il vous plaît lisez cette section à fond, en particulier pour savoir comment créer un rapport de test/bug valide. En cas de doute, merci de ne pas poster un rapport de bug, mais faire une "demande normal d’aide" sur le forum d'aide correspondante.

Pendant vos test de cpg1.5.x, assurez-vous de noter tous les comportements bizarres que vous rencontrez. Cela inclue les erreurs typographiques, les instructions manquantes, ou toutes autres erreurs. Si vous rencontrez une erreur grave, merci de basculer le mode de débogage sur "on" dans la page de configuration et copiez le texte de la fenêtre de débogage de Coppermine dans votre post si un développeur ou quelqu'un qui apporte de l'aide vous le demande explicitement. Cela aidera grandement l'équipe de développement pour l'élimination des problèmes.

Pas d'aide pour les versions alpha et beta

La communauté de Coppermine est disposée à apporter de l'aide sur le forum officiel de Coppermine pour les versions qui ont officiellement été publiées. Cependant, il n'y a pas d'aide pour les versions alpha ou beta, c'est à dire encore en développement. Seules les versions stables ont un support d'aide.

Si vous avez besoin d'aide, vous devrez utiliser la dernière version stable disponible.

Bien entendu, vous êtes les bienvenus pour poster vos rapports de test pour une version encore en développement. Toutefois, il y a parfois une mince ligne entre un rapport de test valide et une demande d'aide: si vous postez quelque chose en rapport avec une version en développement et qu'il apparait clairement que vous avez négligé de lire la documentation et que vous n'avez pas cherché sur le forum d'abord, vous risquez d'avoir une réponse rude, voir pas de réponse du tout.

Parties à regarder de manière particulièrement précise

Merci de rapporter le résultat de vos tests dans la section de test du forum, mais avant d'ouvrir un nouveau sujet, assurez vous que le bug potentiel que vous vous apprêtez à rapporter ne l'a pas déjà été auparavant.

Liste des fonctions

Voici une liste incomplète des fonctions (prise depuis le fichier changelog) qui sont nouvelles ou qui ont été totalement modifiées dans cpg1.5.x et qui doivent être vérifiez de très près. Vous n'avez pas à les tester toutes (même si plus vous en testez mieux c'est). Il y a une autre liste de nouvelles fonctions dans cpg1.5.x que vous pouvez aussi parcourir.

Principales nouvelles fonctions

Le rapport doit inclure

Si vous le pouvez et que votre installation de test est accessible, donnez un lien vers votre galerie de test. Si vous ne pouvez pas, il est généralement utile d'attacher une copie d'écran à votre rapport.

Le résultat de vos tests ne servira pas uniquement à résoudre les problèmes, mais aussi à vérifier la compatibilité de Coppermine avec un maximum de navigateurs et de systèmes d'exploitation. C'est la raison pour laquelle ces informations sont très importantes même si vous ne trouvez que tout va bien - nous aimerions aussi entendre les échos de vos réussites.

Merci pour votre participation et le temps passé pour rendre Coppermine la première galerie photo open-source !

Un seul problème par sujet !

Nous avons une politique stricte "une question par sujet" sur l'ensemble du forum de Coppermine qui s'applique encore plus à la section de test: pour permettre à l'équipe de développement de traquer scrupuleusement chaque bug potentiel, il est absolument obligatoire que vous ne postiez qu'un problème (bug potentiel) par sujet. Si vous trouvez plusieurs bugs potentiels, il est tout à fait indiqué d'ouvrir plusieurs sujets.

Exemple de rapport de test

Pour vous donner une idée de ce à quoi devrait ressembler votre rapport de test voici un exemple (Assurez-vous d'avoir complété les données en rouge avec votre contenu):

Lors du test de cpg1.5.4 sur ma galerie de test sur http://exemple.com/mon_dossier_coppermine/ en utilisant la version du SVN du 2009-07-13 (révision 1234) J'ai noté que lorsque je m'identifie en tant qu'administrateur et quand je clique sur l'option "exporter" du menu administrateur, j'ai le message d'erreur "foo bar blah".
Le serveur de ma galerie test tourne sous Ubuntu Linux 9.04 et Apache 2.2.10 avec GD2 comme librairie graphique et PHP 5.3.0. Je n'utilise pas de passerelle et je n'ai testé qu'avec le thème curve J'ai fais une nouvelle installation. J'ai le message d'erreur ci-dessus quel que soit le navigateur utilisé (J'ai testé avec IE7 et FF3.5 sur Windows XP Home SP3 Français). La langue par défaut de mon navigateur est réglée à Français.

Voici un autre exemple du même rapport de test:

Version de Coppermine: cpg1.5.4
URL de la galerie test: http://exemple.com/mon_dossier_coppermine/
Os du serveur: Ubuntu Linux 9.04
Serveur Web: Apache 2.2.10
Version PHP: 5.3.0
Librairie graphique utilisée: GD2
Intégration: aucune
Thèmes testé: curve
Client OS: Windows XP Home SP3 Français
Navigateur Client: IE7 et FF3.5
Type d'installation: Nouvelle installation
Source: version SVN du 2009-07-13 (révision 1234)
Langue du navigateur: Français
Langue de Coppermine: Français
Ce qui ce passe (bug potentiel): J'ai ce message d'erreur "foo bar blah"
Comment reproduire le problème (ce que j'ai fait lorsque le problème s'est présenté): Je suis identifié en tant qu'administrateur et lorsque je clique sur l'option "exporter" du menu administrateur

Les exemples ci-dessus sont là pour vous montrer ce à quoi peut ressembler votre rapport - vous devrez donner plus d'informations en fonction du type de problème que vous rapportez:

Les rapports invalides des versions qui ne sont pas stable

Nous aimerions vraiment voir votre rapport d'essai pour la nouvelle version, donc ne vous découragez pas s’il y a des règles à suivre. Ce que nous n'avons certainement pas besoin ce sont des rapports comme ceux-ci:

J'ai téléchargé la nouvelle version. Elle ne fonctionne pas.

S'il vous plaît faite vous une faveur à vous-même et à nous: ne déposez pas des rapports stupide, car ils ne feront que conduire à la frustration et seront ignorées ou supprimées, et bien sûr feront rire.

Si vous n'avez aucune idée pourquoi ce rapport est un mauvais exemple, alors vous devriez ne même pas envisager de tester la nouvelle version en premier lieu. Au lieu de cela, vous devriez utiliser la version stable.

Pour tous ceux qui ont lu ce point, voici quelques conseils en plus pour vous: les packages publiés ont un numéro de version. Les fichiers ont des numéros de révision. Il y a une raison à cela. Ne postez pas de bêtises comme "J'ai la dernière version". Ecrivez la version actuelle ou le numéro de révision. Et ne vous contentez pas d’écrire uniquement quelque chose comme "ne fonctionne pas". Nous avons besoin de savoir ce qui s'est réellement passé ("après avoir fait X, Y il ce passe"), aussi détaillé que possible.

Si vous pensez que les règles ici sont tout à fait évidente, alors pensé y encore: nous ne les écrierions pas si elles étaient évidentes pour tout le monde. En fait, nous avons eu un moment difficile dans le passé, lorsque nous avons été inondés de rapports de test invalide. C'est pourquoi nous avions besoin de clarifier les règles.

Disponibilité

Lors du test d'une version (par exemple une version SVN vérifier non publiée), assurez-vous que votre version est à jour.