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.

Rejoignez-nous !

Que puis-je faire pour aider ?

Il existe plusieurs façons de contribuer à MDN, vous pouvez choisir selon vos intérêts et vos compétences.

Si vous ne savez pas par où commencer, vous pouvez toujours demander de l'aide. L'équipe qui gère ce dépôt se réserve le droit de fermer les demandes hors-sujet.

Principaux types de contribution

Pour les contributions en anglais, il existe un tableau de tâches pour les contributions qui permet de trouver facilement des choses à faire qui auront un impact significatif. Ce tableau contient une vue d'ensemble ainsi que des vues séparées pour les différents types de contribution.

En ce qui concerne les contributions en français, vous pouvez consulter les demandes et requêtes avec l'étiquette l10n-fr.

Se préparer à contribuer

Pour contribuer, vous aurez besoin d'un compte GitHub. Si vous n'en avez pas déjà un, inscrivez-vous pour créer un compte avant de continuer. Si vous débutez avec Git et GitHub, nous vous conseillons de lire les articles suivants pour apprendre leur fonctionnement. Avec ces connaissances en main, vous pourrez vous concentrer sur vos contributions sans avoir à apprendre de nouveaux outils en même temps.

Note : Ne vous sentez pas obligé⋅e de lire toutes ces pages pour commencer à contribuer. Avec les deux premiers articles, vous serez déjà bien équipé⋅e.

Note : Si vous avez besoin d'aide ou de conseils en français, n'hésitez pas à nous demander sur Matrix sur le canal l10n-fr.

Lectures complémentaires et ressources d'apprentissage

Étiquette pour la contribution aux projets open source

Si vous n'avez jamais contribué à un projet open source auparavant, nous vous encourageons à lire ce document.

Apprendre le développement web

Si vous débutez en HTML, CSS ou JavaScript, nous avons une section dédiée sur MDN pour vous aider à démarrer.

La collaboration sur les pull requests (en anglais)

Un guide de GitHub sur les différentes façons de collaborer à plusieurs sur les pull requests.

Certaines lectures ou contributions nécessitent une certaine compréhension et expression en l'anglais. Que cela ne soit pas une barrière qui vous empêcherait de contribuer, plusieurs équipes (anglophone et francophone) sont là pour vous aider à participer et à perfectionner vos contributions.

Lorsque vous avez choisi ce que vous voulez faire, vous pouvez consulter le tableau de contribution ou les demandes et requêtes avec l'étiquette l10n-fr, sélectionner un des tickets :

  • Pour les tickets du premier tableau, commentez en anglais et mentionnez @mdn/mdn-community-engagement, quelqu'un de l'équipe vous répondra et vous affectera le ticket.
  • Pour les tickets étiquetés l10n-fr, vous pouvez commenter en français et mentionner @mdn/yari-content-fr, nous reviendrons vers vous rapidement.

De cette façon, on peut s'assurer qu'il n'y a pas deux personnes qui travaillent sur le même ticket en même temps. De plus, cela vous permet de savoir qui contacter en cas de blocage.

Contributions

Lorsque vous contribuez, vous acceptez que vos contributions soient disponibles sous la licence Attribution-ShareAlike (ou toute autre licence déjà indiquée sur la page que vous éditez). De plus, les exemples de code sont disponibles sous la licence Creative Commons CC-0 (dédiée au domaine public).

Si vous avez des questions ou des remarques sur ce qui est discuté ici, veuillez ouvrir une discussion pour nous l'indiquer.