Obtenir de l’aide
Où poser une question, signaler un bug ou un problème de sécurité, et proposer une amélioration
Avant de demander
La plupart des réponses sont déjà écrites ; un rapide coup d’œil évite souvent un aller-retour :
- Cherchez sur ce site avec le champ de recherche en haut de chaque page.
- Cherchez le message d’erreur exact dans Dépannage, et parcourez la FAQ.
- Consultez le journal du serveur (Paramètres, puis Journal du serveur) et la page Statut, qui signalent la plupart des problèmes de configuration.
- Consultez le Changelog : le problème est peut-être déjà corrigé dans une version plus récente.
Où aller
Chaque type de demande a son propre endroit, tous sur GitHub :
| Vous voulez | Allez sur |
|---|---|
| Poser une question ou partager une idée | Discussions |
| Signaler un bug | New issue → Bug report |
| Proposer une fonctionnalité | New issue → Feature request |
| Signaler un problème de sécurité | Report a vulnerability, en privé |
| Corriger ou améliorer cette documentation | Modifier cette page sur GitHub en bas de n’importe quelle page, ou une issue sur le site web |
Signaler un bug
Un signalement reproductible est corrigé le plus vite. Le modèle de rapport de bug demande ceci :
- Version : affichée sous À propos dans le menu d’aide (?) de la barre supérieure
- Déploiement : Docker, Docker Compose, Kubernetes, l’installateur (et son moteur), une installation native ou depuis les sources
- Étapes pour reproduire : ce que vous avez fait, ce que vous attendiez, et ce qui s’est passé à la place
- Éléments de preuve : les lignes pertinentes du journal du serveur, et une capture d’écran quand le problème est visible
Pour un problème avec un formulaire, joignez une définition de formulaire minimale qui le montre. Retirez les mots de passe, les jetons, les noms d’hôtes et toute autre donnée privée des journaux et des formulaires avant de les publier : les issues et les discussions sont publiques.
Signaler un problème de sécurité
N’ouvrez jamais d’issue publique pour cela : utilisez Report a vulnerability, que seuls les mainteneurs voient.
La politique de sécurité liste les versions prises en charge et ce qui se passe après votre signalement.