Contribuer à MDN

MDN Web Docs a besoin de votre aide ! Nous avons un grand nombre de fautes de frappe à corriger, d'exemples à rédiger, de bogues à résoudre, de personnes à qui parler, et bien d'autres choses encore, et ce nombre ne cesse d'augmenter à mesure que les gens commencent à utiliser le site. Cette page présente ce que vous pouvez faire pour nous aider.

Note :

Si vous n'avez jamais contribué à MDN auparavant, le guide Pour commencer explique le processus en quatre étapes simples. Bonne nouvelle, vous en êtes déjà à l'étape 3 : « Découvrir comment vous pouvez aider » !

Que puis-je faire pour aider ?

Il existe plusieurs façons de contribuer à MDN, en fonction de vos compétences et de vos intérêts. Chaque tâche est accompagnée d'une brève description et d'une durée approximative.

Si vous n'êtes pas sûr de ce que vous devez faire, vous êtes toujours invité à demander de l'aide.

Principaux types de contributions

Les liens de cette section mènent à des guides détaillés expliquant comment effectuer une tâche de contribution particulière pour laquelle nous sommes très intéressés par l'aide de la communauté, soit parce qu'il s'agit d'une fonction critique, soit parce qu'elle est associée à un important arriéré. Veuillez envisager d'aider à réaliser ces tâches avant d'envisager de contribuer d'une autre manière.

Tâches Description Compétences requises
Correction des bogues de contenu MDN (en-US) Notre dépôt mdn/translated-content est l'endroit où les gens soumettent des problèmes pour signaler les problèmes rencontrés avec les docs MDN (vous trouverez également des bogues à corriger sur l'ancien dépôt sprints, mais nous allons le fermer à terme). Nous recevons beaucoup de bugs de contenu, et toute aide que vous pouvez apporter pour les corriger serait très appréciée.
  • Connaissance des technologies web que vous choisissez d'utiliser (par exemple, JavaScript, CSS).
  • Une compréhension raisonnable de la langue anglaise (ne vous inquiétez pas si votre anglais n'est pas parfait, nous pouvons vous aider).
Révision des éditions du MDN Les gens soumettent des demandes de compilation sur notre dépôt de contenu tout le temps pour mettre à jour le contenu du MDN, et nous avons besoin d'aide pour les réviser. Rendez-vous sur notre page REVIEWING.md pour découvrir comment fonctionne le processus de révision et comment vous pouvez y participer.
  • Connaissance des technologies web que vous choisissez d'utiliser (par exemple, JavaScript, CSS).
  • Une compréhension raisonnable de la langue anglaise (ne vous inquiétez pas si votre anglais n'est pas parfait, nous pouvons vous aider).
Aider les débutants à apprendre sur MDN Nos pages Apprendre le développement web obtiennent plus d'un million de vues par mois et disposent de forums actifs où les gens se rendent pour demander une aide générale ou demander que leurs évaluations soient notées. Nous aimerions avoir de l'aide pour répondre aux messages et développer notre communauté d'apprentissage.
  • Connaissance des technologies web que vous choisissez d'utiliser (par exemple, JavaScript, CSS).
  • Enthousiasme pour expliquer les sujets techniques et aider les débutants à apprendre à coder.
  • Maîtrise raisonnable de la langue anglaise ; il n'est pas nécessaire qu'elle soit parfaite.

Nous ajouterons d'autres tâches ici au fil du temps.

Notation des priorités

Vous pouvez également consulter les classements de priorité pour vous donner une idée du travail le plus important à réaliser - nous avons commencé à donner aux problèmes de bogues de contenu les étiquettes P0, P1, P2, P3 et P4 pour indiquer leur importance, les chiffres les plus bas étant plus importants que les chiffres les plus élevés.

Ils sont déterminés lors du processus régulier de triage des bogues de MDN, sur la base de la liste des priorités de la documentation MDN.

Autres types de tâches

Si nos principales priorités énumérées ci-dessus ne vous intéressent pas, vous trouverez ci-dessous un certain nombre d'autres types de tâches plus générales dans lesquelles vous pourrez vous impliquer, réparties par type de compétences.

Si vous êtes plus intéressé par les mots, vous pouvez faire ce qui suit :

Si vous êtes plus intéressé par le code, vous pouvez vous essayer à ce qui suit :

Si vous vous intéressez aux mots et au code, vous pourriez vous essayer à ce qui suit :

Note :

Si vous avez trouvé quelque chose d'incorrect sur MDN mais que vous ne savez pas comment le corriger, vous pouvez signaler les problèmes en déposant un problème de documentation. Veuillez donner un titre descriptif au problème. (Il n'est pas utile de dire "Lien mort" sans préciser où vous avez trouvé le lien.

Autres pages utiles

Aide-mémoire GitHub
Cet article fournit une référence rapide aux commandes essentielles dont vous aurez besoin lorsque vous utiliserez Git et GitHub pour contribuer à MDN. Si vous êtes novice dans l'utilisation de ces outils et avez besoin d'un coup de pouce, notre tutoriel GitHub pour les débutants vous enseigne les bases.
Aider les débutants à apprendre sur MDN !
Nos pages Apprendre le développement web obtiennent plus d'un million de vues par mois, et ont des forums actifs où les utilisateurs vont pour demander une aide générale, ou demander que leurs évaluations soient notées. Nous aimerions avoir de l'aide pour répondre aux messages et développer notre communauté d'apprentissage.
Bonnes pratiques GitHub pour MDN
Cette page contient les bonnes pratiques pour travailler avec GitHub et contribuer à MDN, principalement axées sur la façon de travailler avec les issues qui sont les tickets/points à traiter, référencés sur les dépôts GitHub.
Débuter sur MDN
Nous sommes une communauté ouverte de développeuses et développeurs qui créent des ressources pour un meilleur Web, quelle que soit la marque, le navigateur ou la plate-forme. Tout le monde peut contribuer et chaque personne qui le fait nous rend plus forts. Ensemble, nous pouvons continuer à stimuler l'innovation sur le Web pour servir le bien commun. Cela commence ici, avec vous.
Étiquette de base pour les projets open source
Si vous n'avez jamais travaillé sur un projet open source (OSP pour « Open Source Project ») auparavant, il est bon de lire cet article avant de commencer à contribuer à MDN (ou à d'autres projets open source). Il y a quelques bonnes pratiques à adopter qui vous permettront, à vous et aux autres contributrices et contributeurs du projet, de vous sentir valorisés et en sécurité, et de rester productifs.
Faire un retour à propos de MDN Web Docs
Bienvenue sur MDN Web Docs ! Si vous avez des suggestions ou avez des problèmes avec MDN, vous êtes au bon endroit. Nous vous remercions par avance de l'intérêt que vous nous portez.
GitHub pour les débutants
Git et GitHub sont des outils difficiles à apprendre et à maîtriser, mais avec quelques commandes simples et quelques bons conseils, vous devriez pouvoir en faire assez pour commencer à contribuer à MDN sans trop de difficultés. Le but de cet article n'est pas de vous aider à maîtriser Git ou GitHub, mais de vous donner juste assez d'éléments pour être productif à un niveau de base et contribuer à MDN.
Guides "Comment faire"
Ces articles fournissent des guides pas-à-pas pour la réalisation d'objectifs spécifiques lorsque vous contribuez sur MDN.
Liste des priorités de la documentation de MDN
Ce document définit les différents niveaux de priorité sur MDN, et indique quels sujets de documentation existent dans chaque niveau - nous les catégorisons entre Niveau 1 et Niveau 2.
Localiser MDN
Depuis le 14 décembre 2020, MDN fonctionne sur la nouvelle plateforme Yari basée sur GitHub. Cela présente de nombreux avantages pour MDN, mais nous avons dû apporter des changements radicaux à la façon dont nous gérons la localisation. En effet, nous nous sommes retrouvés avec un grand nombre de contenus non maintenus et obsolètes dans nos langues autres que l'anglais et nous voulons mieux les gérer à l'avenir.
Où se trouve tout sur MDN ? Un guide de nos dépôts
MDN est un projet complexe avec de nombreux composants. Contribuer au site est facile au début, si vous avez quelques connaissances de GitHub et que vous commencez par corriger des fautes de frappe ou améliorer des extraits de code. Cependant, lorsque vous commencez à faire des contributions plus importantes, comme l'ajout de nouvelles pages entières, vous remarquerez que de nombreux éléments du contenu ne sont pas stockés dans les sources de la page et proviennent d'ailleurs.
Processus de documentation
Le projet de documentation MDN est énorme; il y a un grand nombre de technologies à couvrir et nous avons des centaines de contributeurs dans le monde entier. Pour aider à mettre de l'ordre dans le chaos, nous avons des processus standard à suivre lorsque vous travaillez sur des tâches spécifiques liées à la documentation. Vous trouverez ici des guides sur ces processus.