Obtenir de l'aide

Le dépôt reçoit les signalements à deux endroits, selon ce que vous avez à dire. Un défaut que vous savez reproduire et une fonctionnalité qui vous manque se signalent dans le gestionnaire d’issues, avec l’un des deux modèles. Une question, un problème que vous ne savez pas encore décrire précisément ou une demande d’aide à l’installation vont dans les Discussions. Aucun des deux n’est un service d’assistance : on vous répond dans la mesure du possible, dans les discussions comme ailleurs.

Une vulnérabilité n’est ni une issue ni une discussion

Signalez-la en privé, par Security → Advisories → Report a vulnerability. Si le signalement privé ne vous est pas accessible, ouvrez une issue publique qui dit seulement que vous avez un problème de sécurité à signaler et qui demande un canal privé, sans aucun détail. SECURITY.md précise le périmètre et le contenu d’un rapport utile.

Avant d’écrire

Consultez Dépannage si quelque chose ne fonctionne pas dans l’application en marche, et Échecs au démarrage si la pile refuse de démarrer. La plupart des premiers signalements relèvent de l’un ou de l’autre, et les deux pages indiquent la ligne du journal à vérifier.

Un rapport de bug

Le modèle demande cinq informations, et ce sont les trois dernières qui permettent à quelqu’un d’agir :

• Ce qui s’est passé, et ce que vous attendiez à la place.
• Les étapes pour reproduire le problème, numérotées, à partir d’un écran que vous savez nommer.
• Le domaine : l’interface, l’accessibilité, l’API, l’import et la restauration, les cours et les intégrations, l’authentification et les sessions, le déploiement, ou « autre ou incertain ».
• La version, telle qu’affichée dans Réglages → À propos. Un suffixe -dev signifie une version construite depuis main et non depuis une publication : recopiez-la telle quelle.
• L’environnement : comment vous faites tourner Badlen, et le navigateur si le problème touche l’interface.

Un champ dédié aux journaux accueille la sortie de docker compose logs app ou de la console du navigateur, quand elle est utile.

Nettoyez les chiffres d’abord

Badlen contient vos données financières, et une issue est publique et permanente. Retirez les montants, les numéros de compte et les noms de tout ce que vous collez, y compris dans un extrait de journal ou une capture d’écran.

Une demande de fonctionnalité

L’autre modèle s’intéresse au besoin plutôt qu’à la solution : ce qui est impossible ou pénible aujourd’hui, comment vous imaginez la fonction si vous avez une idée, et le domaine concerné.

Un champ mérite une attention particulière. Pour une nouvelle source de données, le modèle demande quel fournisseur, et s’il propose un accès gratuit ou sans clé : Badlen n’intègre que des sources qu’un auto-hébergeur peut joindre sans contrat payant, et une demande portant sur un fournisseur sous contrat ne peut donc pas être retenue, quels que soient ses mérites.

Une question qui n’est pas un signalement

Posez-la dans les Discussions, comme tout ce que vous ne savez pas encore décrire étape par étape : une installation qui ne démarre pas, un chiffre qui ne correspond pas à ce que vous attendiez, une décision que vous hésitez à prendre. Précisez quelle page de ce site vous avez lue et à quelle question elle n’a pas répondu : c’est aussi comme cela que les pages de ce site s’améliorent. Si une discussion met au jour un défaut reproductible, il devient ensuite une issue.

Pour modifier quelque chose vous-même, voyez Contribuer.