Aller au contenu principal

Les issues dans Electron

Comment contribuer à la résolution de problèmes​

Pour tout problème, il y a fondamentalement trois façons de contribuer :

  1. En ouvrant le problème pour discussion : si vous pensez avoir trouvé un nouveau bogue dans Electron, vous devrez le signaler en créant un nouveau ticket dans le electron/electron traqueur de tickets.
  2. En aidant à trier le problème : vous pouvez le faire soit en fournissant des détails supplémentaires (un cas de test reproductible qui démontre un bogue) soit en fournissant des suggestions pour résoudre le problème.
  3. En aidant à résoudre le problème : cela peut être fait en démontrant que le problème n'est pas un bug ou qu'il est résolu ; mais plus souvent, en ouvrant une pull request (demande de tirage) qui modifie la source dans electron/electron d'une manière concrète et vérifiable.

Demander de l'aide générale​

Le site d'Electron dispose d'une liste de ressources pour obtenir de l'aide pour la programmation, le signalement des problèmes de sécurité, comment contribuer, et plus. Veuillez n'utiliser le gestionnaire de tickets que pour les bugs !

Envoi d'un rapport de bug​

Pour soumettre un bug :

Lors de l'ouverture d'un nouveau ticket dans le suiveur de ticketselectron/electron, un modèle devant être rempli sera affiché.

Si vous pensez avoir trouvé un bogue dans Electron, veuillez remplir le modèle le mieux possible.

Les deux informations les plus importantes nécessaires pour évaluer le rapport sont la description du bug et un simple cas de test pour le recréer. Il est plus facile de corriger un bug s'il peut être reproduit.

Voir pour cela: Comment créer un exemple minimal, complet et vérifiable.

Triage d'un rapport de bug​

Il est fréquent que les questions ouvertes impliquent des discussions. Certains contributeurs peuvent avoir des opinions différentes, y compris si le comportement est un bogue ou une fonctionnalité. Ces discussions font partie du processus et doivent rester ciblées, utiles, et professionnelles.

Les réponses laconiques ne fournissant pas de contexte supplémentaire, ni de détails complémentaires sont inutiles ou non professionnelles. Pour beaucoup, de telles réponses paraitront ennuyeuses et peu amicales.

Les contributeurs sont encouragés à résoudre les problèmes de manière collaborative et à aider les autres à progresser. Si vous rencontrez une déclaration de problème que vous estimez invalide ou qui contient des informations incorrectes, expliquez pourquoi vous la considérez comme telle, tout en étant conscient que vous pouvez avoir tort. Ce faisant, nous pouvons souvent atteindre le résultat correct plus rapidement.

Résolution d'un rapport de bug​

La plupart des issues sont résolus en ouvrant une pull request. Le processus d'ouverture et de révision d'une pull request est similaire à celui de l'ouverture ou du triage des tickets. mais implique un réexamen et un workflow d'approbation qui s'assure que les changements proposés satisfont à la qualité minimale et aux directives fonctionnelles du projet Electron.