MahokuTesters

Le dépôt dédié aux testeurs de Mahoku

Guide pour un rapport de bug parfait

Un bug est un problème démontrable causé par le code du jeu ou l'intéraction de l'utilisateur avec celui-ci. De bons rapports de bugs sont extrêmement utiles - merci ! 🙏

Lignes directrices pour les rapports de bugs:

1. Utilisez la recherche de problèmes GitHub — vérifiez si le problème a déjà été signalé.

2. Vérifiez si le problème a été résolu — essayez de le reproduire en utilisant la dernière version de développement à laquelle vous avez accès.

3. Isolez le problème — réduisez au minimum le nombre d'étapes nécessaires pour produire le bug et ciblez la nature de celui-ci.

Un bon rapport de bug ne devrait pas obliger les autres à vous courir après pour obtenir plus d'informations. Veuillez essayer de détailler autant que possible votre rapport. Quelle machine utilisez-vous et avec quels paramètres? Quelles étapes permettront de reproduire le bug? Avec quel système d'exploitation rencontrez-vous le problème? À quoi vous attendiez-vous? Tous ces petits détails aideront d'avantage les développeurs à corriger les bugs potentiels.

Exemple:

Exemple de titre de rapport de bug court et descriptif

Un résumé du problème et de l'environnement du système d'exploitation dans lequel il se produit. Si approprié, incluez les étapes nécessaires pour reproduire le bug.

1. C'est la première étape
2. C'est la deuxième étape
3. Étapes ultérieures, etc.

<pièce-jointe> - une capture d'écran, une vidéo du problème

Toute autre information que vous souhaitez partager et qui est pertinente pour le problème signalé. Cela peut inclure les lignes de code que vous avez identifiées comme étant à l'origine du bug, et les solutions potentielles à ce bug (ainsi que vos avis sur leur mérite).

Quelle gravité appliquer pour mon signalement de bug?

Si vous hésitez lors du choix de la gravité du bug trouvé, n'hésitez pas à vous servir de ce tableau comme référence:

Gravité	Description	Exemples
Blocage	Empêche la poursuite des tests lorsque le jeu plante à cause d'un bug	Le jeu se ferme lorsqu'on complète la première quête
Critique	Concerne la sécurité du jeu et conduit à l'arrêt d'un programme, à la perte de données, ou à tout autre dommage important. De tels bugs nuisent aux fonctionnalités principales de l'application et sont résolus en priorité	La sauvegarde n'enregistre que la position du joueur
Majeure	Affecte négativement une grande partie du jeu que l'on est en train de tester	Par exemple, lorsque l'on teste les traductions: lettres non affichées, omissions systématiques d'espaces, texte dépassant des limites de l'écran, texte non traduit, etc.
Mineure	N'influence ni les fonctions de base de l'application ni le processus de test	Le texte ne tient pas dans une barre séparée, il y a une césure incorrecte, un espace manquant à un endroit particulier, etc.
Banale	A peu d'impact sur le fonctionnement du jeu. On trouve généralement ce type de bug au cours des tests d'interface utilisateur	Mauvaise taille d'un bouton, couleur trop vive d'un objet, etc.

Où trouver mon fichier de logs et comment l'ajouter à mon signalement?

Voici l'emplacement du fichier de logs pour chaque système d'exploitation:

Utilisez la combinaison de touches de la colonne "Raccourci" puis entrez l'emplacement du fichier de logs. Appuyez ensuite sur Entrée ou OK pour accéder au dossier contenant le fichier de logs.

Système d'exploitation	Emplacement	Nom du fichier	Raccourci
Windows	%USERPROFILE%\AppData\LocalLow\Mahoku\Mahoku\	Player.log	⊞ Win + R
Plateformes Universelles Windows (UWP)	%USERPROFILE%\AppData\Local\Packages\Mahoku\TempState\	UnityPlayer.log	⊞ Win + R
Linux	~/.config/unity3d/Mahoku/Mahoku/	Player.log	Ctrl + F10 E
MacOS	~/Library/Logs/Mahoku/Mahoku/	Player.log	-

Lorsque vous envoyez votre signalement, une zone de texte située à la fin de votre signalement vous permet d'ajouter un fichier de logs. Cliquez sur cette zone pour la mettre en surbrillance puis glissez-y simplement le fichier pour l'ajouter à votre signalement.

Demandes d'ajout de nouvelles fonctionnalités

Les demandes d'ajout de fonctionnalités sont les bienvenues. Mais prenez un moment pour savoir si votre idée correspond à la portée et aux objectifs du projet. C'est à vous de faire en sorte de convaincre les développeurs du projet du bien-fondé de cette fonctionnalité. Veuillez fournir autant de détails et de contexte que possible.