Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.
Cette page devrait vous guider parmi les premières étapes de contribution à Mozilla. Bienvenue, nous sommes ravis de vous accueillir ! :)
Besoin d'aide ?
La communauté Mozilla accueille toujours 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 Mike Hoye à l'adresse [email protected] (en anglais).
De quelles connaissances ai-je besoin ?
Mozilla est un projet de grande envergure et nous sommes ravis de rencontrer des contributeurs aux compétences diverses et variées.
- Si vous connaissez le C++, par exemple, vous pouvez contribuer au coeur de Firefox, Firefox OS ou d'autres projets Mozilla.
- Si vous avez des connaissances en JavaScript ou en HTML/CSS, vous pouvez contribuer au développement front-end de Firefox, ou à Gaia, la couche applicative de Firefox OS.
- Si vous connaissez le Java, vous pouvez participer à Firefox Mobile - Firefox sur Android - et MozStumbler.
- Si vous connaissez le PHP, vous pouvez contribuer à Transvision, Marketplace.PHP et l'extension MediaWiki de Bugzilla.
- Si vous connaissez le Python, vous pouvez aider aux services web, comme par exemple Firefox Sync ou Persona.
- Si vous connaissez le Make,le shell,le Perl, ou le Python, vous pouvez contribuer à notre système de build.
- Si vous connaissez le C, vous pouvez contribuer à Heka, un outil pour le traitement des données.
- Et il y beaucoup de manières de contribuer à la mission de Mozilla sans savoir programmer. Si vous voulez être impliqués dans le design, le support, la traduction, le test, ou d'autres types de contribution, allez voir la page des opportunités de volontariat.
Vous ne savez peut-être pas encore programmer mais vous avez envie de commencer à apprendre ? C'est également une bonne chose, le programme Webmaker est pour vous, et il y a de nombreux cours disponibles sur le Réseau Mozilla des développeurs !
Les autres produits de Mozilla - y compris les versions binaires de Thunderbird supporté par la communauté - peuvent être découvert grâce à des recherches rapides et il est courant de ne pas avoir à compiler quoique soit pour faire une contribution.
Étape 1 - Compiler Firefox, Firefox pour Android ou Firefox OS.
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 :
- Recherchez sur bugzilla pour les mots clés pertinents,
- Trouvez le composant bugzilla dans lequel votre bête noire se situe, en utilisant la liste des composants. Parcourez bugzilla pour voir les bogues associés.
- Demandez dans #introduction ou #developers sur irc.mozilla.org.
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 :
- Regardez https://developer.mozilla.org/Fr/Developer_Guide
- Demandez de l'aide dans un commentaire sur un bogue, ou dans #introduction ou #developers.
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 :