Contribuer à Mozilla

Cette page devrait vous guider parmi les premières étapes de contribution à Mozilla. Bienvenu, nous sommes ravis de vous accueillir :)

Besoin d'aide ?

La communauté Mozilla accueille chaleureusement les arrivants en son sein. Si vous rencontrez des difficultés à votre arrivée, vous pouvez poser des questions sur le canal de discussion #introduction sur irc.mozilla.org (anglophone) ou #frenchmoz (en français). Si vous avez toujours des problèmes, veuillez contacter Kyle Huey à l'adresse khuey@mozilla.com (en anglais).

Pas de connaissances en C++ ?

Nous avons beaucoup de tâches et de projets qui ne demandent pas que vous connaissiez le C++. Référez-vous à l'autre introduction.

Étape 1 - Compiler Firefox, Thunderbird ou une autre application

Suivez nos étapes pour une compilation simple de Firefox, ou pour compiler Thunderbird. Ce n'est pas très compliqué, mais peut prendre du temps, donc vous pourrez passer aux étapes suivantes pendant la compilation.

Plus d'instructions concernant la compilation peuvent être trouvées ici.

Étape 2 - Comprendre comment la contribution à Mozilla se passe

Référez-vous à Mozilla Firefox: Development Process. Thunderbird utilise un processus similaire.

Étape 3 - Trouver quelque chose à faire

Réparez votre bête noire

S'il y a quelque chose que vous souhaitez corriger dans Firefox, Thunderbird ou votre application Mozilla préférée, cela peut être l'occasion de débuter. Il y a de nombreuses manières d'y arriver :

Trouvez un bogue qui a été marqué comme adapté pour les arrivants

Les développeurs de Mozilla marquent certains bogues comme étant simples pour que les arrivants s'habituent à nos processus :

  • Les bogues encadrés (ou l'interface alternative moins pratique) ont un mentor qui s'engage à aider à chaque étape. Généralement, l'information disponible est suffisante pour commencer. Dès que vous avez besoin d'aide, contactez le mentor par IRC, dans la page de bogue associée ou par courriel. Quand le bogue est corrigé, il vous aidera à insérer votre code dans l'arborescence.
  • Les « bons » premiers bogues peuvent être un peu anciens, mais à un certain moment ils ont été considérés comme des bogues adaptés pour débuter. Nous sommes en train de déplacer ces bogues vers des bogues encadrés, mais les « bons premiers bogues » récents sont de bons points de départ s'il n'y a pas de bogues encadrés appropriés.
  • Les projets étudiants sont de plus grande échelle, et adaptés à l'attribution de crédits pour un étudiant universitaire. Même si vous n'êtes pas étudiant, vous pouvez tout à fait corriger ces bogues.

Étape 4 - Corriger le bogue

Nous mettons cela entre vos mains compétentes. Nous avons quelques ressources pour vous aider :

Si le bogue que vous corrigez nécéssite probablement une mise à jour de la documentation pour les développeurs une fois corrigé, assurez-vous d'ajouter le mot-clé dev-doc-needed au bogue (ou demandez à quelqu'un de le faire si vous n'avez pas les privilèges editbugs sur Bugzilla). Ceci marque le bogue sur le radar de l'équipe de documentation pour s'assurer que la documentation soit mise à jour correctement une fois le bogue résolu. Si vous ne marquez pas le bogue, votre travail peut être manqué par l'équipe de documentation ! Il est possible d'ajouter le mot-clé à n'importe quel moment ; pas besoin d'attendre que ce soit corrigé.

Bien sûr, notre documentation est un wiki, vous pouvez mettre à jour la documentation par vous-même. Même si vous n'êtes pas à l'aise en rédaction, gardez à l'esprit que nos lutins documenteurs passeront après vous et nettoierons pour vous.

Étape 5 - Faire relire votre code

Une fois que vous ayez corrigé le bogue, attachez la rustine sur le bogue (en), et demandez une relecture. Pour faire cela, cliquez sur le lien Details dans votre pièce-jointe, et changer le marqueur review à ? et entrez l'identifiant bugzilla du relecteur dans le champ qui apparaît (soit son adresse courriel ou le :NomUnique qu'ils donnent). C'est très important d'attacher un identifiant bugzilla, ou la requête sera manquée. Si comment savoir quelle est la bonne personne pour votre relecture ?

  • Si vous avez un bogue encadré, demandez à votre mentor, il ou elle saura ou trouvera rapidement.
  • Lancez hg blame et regardez les personnes qui ont touchées aux fonctions sur lesquelles vous avez travaillé, ce sont de bons candidats.
  • Le bogue lui-même peut contenir des indications claires de la personne à qui confier la relecture.
  • Existe-t-il d'autres bogues sur des sujets similaires ? Dans ce cas, le relecteur de ces bogues peut être un bon choix.
  • Nous avons une liste des modules qui n'est plus à jour et recense les responsables et contributeurs du module, certains seront de bons relecteurs. Dans le pire des cas, marquez le responsable du module comme relecteur et suggérez en commentaire de choisir quelqu'un plus apte s'il ou elle manque de temps.

Étape 5b - Faire le suivi

Si vous avez demandé une relecture, mais que le relecteur ne s'est pas manifesté après quelques jours, n'hésitez pas à les relancer. Ajoutez simplement un commentaire au bogue en disant « review ping? » s'il n'a pas répondu quelques jours plus tards. S'il n'a toujours pas répondu, demandez de l'aide dans #introduction ou #developers.

Étape 6 - Répondre à la relecture

Bien souvent, un relecteur demandera des modifications, peut-être mineures, parfois majeures. Dans chacun des cas, corrigez ce que le relecteur demande. Si vous n'êtes pas sûr de comment le faire, demandez ! Attachez le nouveau correctif au bogue, et demandez à nouveau pour une relecture avec la même personne. S'ils vous donnent un r+ cela signifie que votre correctif est accepté dans l'arborescence !

Étape 7 - Mettre véritablement votre code dans l'arborescence

Puisque vous n'avez pas la possibilité de pousser du code sur l'arbre, vous devez demander à quelqu'un de vous aider. Si vous avez un mentor, demandez lui. Sinon, demander au relecteur. Si le relecteur est trop occupé, signaler qu'un « commit » est nécessaire en ajoutant le mot-clé checkin-needed. Une personne devrait s'en occuper en quelques jours et pousser le code dans le dépôt, et marquer le bogue comme résolu.

Étape 8 - Recommencer

Félicitations, vous avez corrigé votre premier bogue. Maintenant, retournez à l'étape 3 et recommencez. Puisque vous avez fait votre premier bogue, vous pouvez demander le niveau 1 d'accès au dépôt pour que vous puissiez pousser vers le serveur d'essai et obtenir un retour d'informations automatique à propos de vos modifications sur plusieurs plateformes. Après avoir corrigé un certain nombre de bogues non évidents, vous pouvez demander l'accès au niveau 2 ou 3 (selon le dépôt que vous utilisez) pour que vous puissiez pousser votre propre code s'il a été accepté après relecture.

Plus d'information

Nous sommes en train d'améliorer l'information pour les arrivants sur le projet. Nous ajouterons plus d'informations sur ces pages bientôt, mais d'ici là vous pourrez les trouver aux endroits suivants :

Étiquettes et contributeurs liés au document

Étiquettes :
Contributeurs ayant participé à cette page : ethertank, Goofy, lomalick@gmail.com, BenoitL, FredB, AmarOk1412
Dernière mise à jour par : AmarOk1412,