Obtenir de l'aide

Les signalements vont au gestionnaire d’issues du dépôt, sous l’un des deux modèles. Il n’y a pas de service d’assistance derrière : une réponse est un effort au mieux, pas un engagement de service.

Une vulnérabilité n’est pas une issue

Signalez-la en privé, par Security → Advisories → Report a vulnerability. Si le signalement privé ne vous est pas accessible, ouvrez une issue publique disant seulement que vous avez un rapport de sécurité et demandant un canal, sans aucun détail. SECURITY.md porte le périmètre et ce que contient un rapport utile.

Avant d’écrire

Lisez Dépannage pour ce qui casse dans une application en marche, et Échecs au démarrage pour une pile qui ne monte pas. La plupart des premiers signalements sont l’un ou l’autre, et tous deux nomment la ligne de journal à regarder.

Un rapport de bug

Le modèle demande cinq choses, et les trois dernières sont ce qui décide si quelqu’un peut agir dessus :

• Ce qui s’est passé, et ce que vous attendiez à la place.
• Les étapes pour reproduire, numérotées depuis un écran que vous pouvez 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 sans certitude.
• La version, telle que Réglages → À propos l’annonce. Un suffixe -dev veut dire une version construite depuis main plutôt que depuis une publication, ce qui vaut la peine d’être dit tel quel.
• L’environnement : comment vous le faites tourner, et le navigateur si le problème est dans l’interface.

Une case de journaux accueille docker compose logs app ou la console du navigateur quand l’un ou l’autre est pertinent.

Nettoyez les chiffres d’abord

Badlen détient 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, un extrait de journal et une capture d’écran compris.

Une demande de fonctionnalité

L’autre modèle demande le besoin plutôt que la réalisation : ce qui est impossible ou pénible aujourd’hui, comment vous imaginez que cela marche si vous avez un avis, et le domaine dont cela relève.

Un champ vaut la peine d’être rempli correctement. Une demande de nouvelle source de données demande quel fournisseur, et s’il a un point d’accès gratuit ou sans clé : Badlen ne livre que des sources qu’un auto-hébergeur peut atteindre sans contrat payant, si bien qu’un fournisseur derrière un contrat est une demande impossible à prendre quels que soient ses mérites.

Une question qui n’est pas un signalement

Le dépôt accepte les issues vierges, si bien qu’une question qui n’entre dans aucun des deux modèles a quand même sa place. Dites quelle page de ce site vous avez lue et ce qu’elle a laissé ouvert. C’est aussi ainsi qu’une page d’ici se corrige.

Changer quelque chose vous-même, c’est Contribuer.