Cet article nécessite une relecture technique. Voici comment vous pouvez aider.
Cet article nécessite une relecture rédactionnelle. Voici comment vous pouvez aider.
Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.
Nous sommes une communauté ouverte de développeurs et rédacteurs et nous créons des ressources afin de rendre le Web meilleur, quels que soient la marque du matériel, le nom du navigateur ou la plate-forme de développement. Chacun peut contribuer et chaque contribution est la bienvenue. Ensemble nous pouvons continuer à innover sur le Web et aider chacun de ses utilisateurs. Cela commence ici, avec vous.
Chaque composant de MDN (les documents, les démonstrations, le site lui-même) est créé par une communauté ouverte : rejoignez-nous !
3 étapes pour contribuer à MDN
MDN est un wiki : n'importe qui peut ajouter et éditer du contenu. Vous n'avez pas besoin d'être un développeur ou de vous y connaître beaucoup en technologie : il y a tellement de choses à faire ! Des plus simples (comme la relecture ou la correction typographique) jusqu'aux plus complexes (comme l'écriture de la documentation d'une API).
Contribuer est facile et sûr. Même si vous faites une erreur, il sera facile de la corriger. Si vous n'êtes pas sûr et certain de ce à quoi doivent ressembler les choses ou que votre grammaire n'est pas parfaite, ne vous inquiétez pas ! Il existe d'autres bénévoles dont la tâche sera de s'assurer de la qualité du contenu de MDN. Il y aura toujours quelqu'un pour vérifier que votre travail est propre et bien écrit. Partagez juste vos connaissances et suivez vos points forts : faites confiance au reste de la communauté pour améliorer encore votre travail.
Étape 1 : Créer un compte sur MDN
Pour commencer à contribuer sur MDN, il est nécessaire d'avoir un compte. Pour plus de détails à ce sujet : comment créer un compte.
Étape 2 : Choisir une tâche
Une fois connecté, vous pouvez lire les descriptions des tâches proposées ci-dessous et décider de celle que vous voulez réaliser. Choisissez celle qui vous attire le plus pour commencer à contribuer !
Étape 3 : Effectuer cette tâche
Une fois que vous avez choisi un type de tâche, vous pouvez trouver une page, un exemple de code, etc. sur quoi travailler !
Ne vous inquiétez pas si cela n'est pas parfait ; d'autres contributeurs MDN sont ici pour aider à réparer les erreurs qui pourraient vous échapper. Si vous avez des questions, jetez un œil sur la page Rejoindre la communauté où vous trouverez les listes de diffusion et les salons de discussions où vous pourrez trouver des réponses.
Note : Si vous voulez faire des expériences avant de faire une modification « pour de vrai », vous pouvez éditer la page Bac à sable. Limitez s'il vous plaît vos expérimentations à cette page. Ne faites pas de changements inutiles sur les pages de contenu afin d'observer le résultat ; ceci perturbe les lecteurs et augmente la charge de travail des autres contributeurs qui doivent corriger/nettoyer.
Une fois que c'est fait, choisissez-en une autre ou voyez ce que vous pouvez faire d'autre sur MDN.
Les différents types de tâches
Vous pouvez emprunter plusieurs chemins pour contribuer sur MDN. Cela dépend avant tout de vos compétences, de vos intérêts et de votre curiosité. Bien que certaines tâches semblent difficiles, il en existe beaucoup qui peuvent être effectuées en quelques minutes ! Dans la liste qui suit, vous trouverez les tâches, leur description ainsi que le temps moyen estimé pour les mener à bien.
Option 1 : J'aime lire, écrire...
Vous pouvez nous aider à relire ou éditer certains articles et également les étiqueter (tagger) pour qu'ils soient mieux triés.
- Rédiger le résumé d’une page (5 à 15 minutes)
- Effectuer une relecture rédactionnelle (5 à 30 minutes)
- Mettre à jour un article existant avec de nouvelles informations (5 minutes à 1 heure)
- Rédiger un article sur une nouvelle technologie ou API (30 minutes à 2 heures)
Option 2 : J'aime coder
Nous avons besoin de davantage d'exemples de codes ! Vous pouvez également contribuer à la plate-forme du site : Kuma.
- Convertir des exemples de codes en exemples « live » (30 minutes)
- Mettre en place votre environnement Kuma (explications en anglais) (1 heure)
- Soumettre un patch pour Kuma (explications en anglais) (1 heure)
- Envoyer une nouvelle démo (1 heure)
Option 3 : J'aime coder mais aussi écrire
Certaines tâches requièrent des compétences linguistiques et informatiques comme l'écriture de nouveaux articles, des relectures techniques ou de l'adaptation de documents.
- Étiqueter les pages JavaScript (5 minutes)
- Promouvoir MDN sur votre propre site (5 minutes)
- Effectuer une relecture technique (30 minutes)
- Mettre à jour une page d'API (explications en anglais) (30 minutes)
- Écrire un nouvel article sur un sujet que vous connaissez (1 heure ou plus)
Option 4 : Je veux que MDN soit traduit
Chaque travail de localisation et de traduction sur MDN est fait par une communauté de volontaires extraordinaires. Cet article liste chaque projet de localisation, les contributeurs et d'autres détails.
- Traduire des pages (2 heures)
- Se connecter avec d'autres traducteurs listés dans les projets de traduction (30 minutes)
Option 5 : J'ai trouvé une information incorrecte mais je ne sais pas comment la corriger
Vous pouvez rapporter des problèmes en remplissant une fiche de bogue. (5 minutes)
Les valeurs à utiliser sont :
Champ Bugzilla | Value |
product |
Developer Documentation |
component |
[choisissez un élément approprié pour le sujet ou bien « General » si vous n'êtes pas sûr(e) ou que vous ne voyez rien qui corresponde] |
URL |
La page où vous avez trouvé le problème |
Description |
Autant d'informations que possible pour décrire le problème et les façons de trouver les bonnes pistes pour le résoudre (y compris des personnes qui pourraient aider ou bien des liens vers les bons documents). |
Les autres choses à faire sur MDN
- Rejoindre la communauté MDN.
- Remplir son profil afin que les autres utilisateurs puissent mieux vous connaître.
- Lire d'autres documents sur comment contribuer à MDN.