Skip to content

Signaler un problème ou proposer une amélioration

Signaler un problème

Avant le signalement

Si vous pensez avoir trouvé un bug ou un comportement étrange de la part de l'application, il peut être important de le faire remonter à l'équipe de développement. Avant cela, quelques vérification s'imposent.

  1. Si vous êtes utilisateurices, s'assurer auprès des admins de votre instance que Hiboo est à jour. Vous pouvez aussi le vérifier par vous-mêmes en comparant le numéro de version indiqué en bas à gauche de l'interface Hiboo avec celle de la dernière publication officielle.
  2. Vérifier auprès des admins et dans la documentation que le problème rencontré ne vient pas en fait d'un comportement prévisible.
  3. Vérifier dans la liste des bugs de la forge de Hiboo que le problème n'est pas déjà répertorié.
Différentes manières de faire remonter un problème

Une fois ces précautions prises, si le problème doit être remonté, plusieurs possibilités s'offrent à vous (elles ne sont pas exclusives) :

Expliquer correctement le problème rencontré

Afin que la prise en charge du problème soit la plus efficace possible, il est nécessaire de l'expliquer de manière exhaustive. C'est-à-dire :

Résumer le problème

Une formulation du type « le thème sombre ne fonctionne pas » ne sera jamais considérée comme suffisante. « Ne fonctionne pas » peut vouloir dire que les couleurs affichées ne sont pas celles attendues, ou que le thème ne devient pas sombre quand on clique sur le bouton de changement de thème, ou encore que le thème automatique ne respecte pas la préférence « mode sombre » du système. C'est à partir de ce niveau de détail que le problème devient traitable.

Donner les moyens de reproduire le problème

Dans quelles conditions le problème est-il apparu ? C'est à cette question qu'il faut répondre dans un deuxième temps. Par exemple :

  1. Indiquer au système une préférence pour le mode sombre
  2. Ouvrir Hiboo sur son navigateur et s'assurer que le thème est réglé sur « Auto »

Résultat : Hiboo est en mode clair.

Ceci permettra aux contributeurices d'essayer de reproduire le bug et, s'il ne semble pas possible de le reproduire, de vous poser des questions plus précises sur son apparition.

Indications supplémentaires

En fonction du problème signalé, il peut être utile de donner d'autres informations. Notamment :

  • la version de Hiboo utilisée,
  • si le problème concerne l'utilisation de l'interface, le navigateur utilisé,
  • si le problème concerne le développement, la version de Python
  • si le problème concerne un service en particulier, le nom de ce service et la manière dont il est connecté à Hiboo.

Proposer une amélioration

Si vous avez une idée d'amélioration, ou carrément de nouvelle fonctionnalité pour Hiboo, vous pouvez tout à fait en faire part à l'équipe de développement. Pour cela, le mieux est d'abord de rejoindre le canal de discussion de Hiboo sur le salon [matrix] dédié, #acides:tedomum.net. Vous pourrez ici proposer vos idées et en discuter avec les contributeurices.

Rien ne vous empêche, en parallèle ou suite à vos discussions, d'ouvrir un ticket sur la forge de Hiboo, ce qui nécessite de créer un compte sur https://forge.tedomum.net.

L'équipe de développement fera tout ce qu'elle peut pour étudier votre idée et pour échanger avec vous, et pour vous aider à l'implémenter par vous-mêmes si vous souhaitez contribuer au développement de Hiboo. Pour autant, il faut garder à l'esprit qu'une idée peut être rejetée ou non mise en œuvre pour des raisons variées. Notamment si :

  • elle ne s'inscrit pas directement dans les objectifs de Hiboo,
  • elle nécessite des changements trop radicaux dans l'architecture du code,
  • elle nécessite des compétences qu'aucun·e contributeurice ne possède,
  • elle concerne des cas d'usage trop spécifiques.