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

Débuter sur MDN

Nous sommes une communauté ouverte de développeuses et développeurs, d'écrivaines et d'écrivains techniques qui créent des ressources pour un Web meilleur, quelle que soit la marque, le navigateur ou la plate-forme. Tout le monde peut contribuer et chaque personne qui le fait améliore le projet. Ensemble, nous pouvons continuer à stimuler l'innovation sur le Web pour servir le bien commun. Cela commence ici, avec vous.

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.