We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

Si vous êtes parvenu à cette page du premier coup ou après avoir longuement cherché, cela signifie probablement que vous souhaitez contribuer à l'« Espace d'Apprentissage du MDN » (aussi appelée Learning Area). Excellente nouvelle !

Sur cette page, vous trouverez tout ce dont vous aurez besoin pour aider à améliorer le contenu pédagogique sur MDN. Vous pouvez contribuer de nombreuses façons, selon le temps que vous avez ou que vous souhaitez y passer, que vous soyez un débutant, un développeur web, ou un enseignant.

Note : Vous pouvez trouver un guide pour écrire un nouvel article sur Comment rédiger un article pour aider les gens à se familiariser avec le Web..

Trouver une tâche spécifique

Un moyen courant utilisé par les contributeurs à l'« Espace d'Apprentissage » est de lire les articles, corriger les fautes de frappe et suggérer des améliorations. Vos exemples sont également les bienvenus sur notre dépôt GitHub, et vous pouvez prendre contact avec nous si vous voulez demander ce qui doit être fait.

Contribuer représente également une excellente méthode pour apprendre tout en s'amusant. Si vous vous sentez perdu et/ou si vous avez des questions, n'hésitez pas à nous contacter via la liste de diffusion (anglophone) ou notre canal IRC (anglophone) (voir en pied de page pour plus de détails). Chris Mills est le responsable du projet pour l'« Espace d'Apprentissage » — vous pouvez aussi essayer de le contacter directement.

Les paragraphes suivants donnent quelques idées générales des types de tâches que vous pouvez réaliser.

Je suis un débutant

Fantastique ! Les retours des débutants sont particulièrement précieux lorsqu'il s'agit d'écrire des articles pédagogiques. Votre point de vue est unique, car vous faites partie du public visé par ces articles, ce qui peut faire de vous un membre inestimable de notre équipe. En effet, si vous utilisez un de nos articles pour apprendre quelque chose et que vous êtes bloqué, ou si vous trouvez l'article déroutant d'une certaine manière, vous pouvez le corriger ou nous le faire savoir afin que nous puissions être sûrs qu'il sera corrigé.

Voici quelques façons de contribuer :

Ajouter des étiquettes aux articles (5 min)
Étiqueter le contenu de MDN est le moyen le plus simple de contribuer sur MDN. Comme beaucoup de nos fonctionnalités utilisent des balises pour aider à présenter l'information dans son contexte, aider à l'étiquetage est une contribution très précieuse. Jetez un oeil sur les listes des termes du glossaire et aux articles de la section d'apprentissage qui n'ont pas d'étiquettes. (Pour le français, utiliser des termes français, ceux qu'un francophone envisagera de rechercher)
Lire et effectuer une relecture d'un terme du glossaire (5 min)
Nous avons besoin de votre regard neuf sur le contenu qui a été rédigé. Si vous trouvez qu'un terme du glossaire est difficile à comprendre, cela signifie que sa définition doit être améliorée. N'hésitez pas à apporter les changements que vous estimez nécessaires. Si vous ne pensez pas avoir les compétences requises pour modifier l'entrée en question, dites-le nous sur la liste de diffusion.
Rédiger une nouvelle définition dans le glossaire (20 minutes)
La méthode la plus efficace pour apprendre quelque chose de nouveau est de : choisir un concept que vous aimeriez comprendre, en apprendre le plus possible à ce sujet et expliquer ce concept dans le glossaire. Expliquer quelque chose aux autres est une excellente façon de vérifier que vous avez bien compris et aide énormément à ancrer cette connaissance dans votre mémoire. Vous aurez ainsi fait quelque chose pour vous et aussi pour les autres. Gagnant gagnant !
Lire et effectuer une relecture d'un article pédagogique (2 heures)
Cetta action a beaucoup d'analogies avec la relecture d'un terme du glossaire présentée plus haut ; mais elle prendra plus de temps car les articles sont généralement plus longs.

Je suis un développeur web

Parfait, vos compétences techniques sont l'ingrédient idéal pour que nous soyons sûrs de fournir un contenu pédagogique et techniquement précis pour les débutants. Cette section du MDN est dédiée à l'apprentissage des concepts du Web, il est donc nécessaire que les explications fournies soient aussi simples que possible, sans être simplistes et donc inutilisables . Il est plus important d'être compréhensible que de donner une foultitude de détails.

Lire et effectuer une relecture d'une définition du glossaire (5 min)
En tant que développeur web, vous pouvez nous aider à ce que le contenu soit précis sur le plan technique, sans pour autant qu'il soit pédant. N'hésitez pas à modifier les articles si vous pensez que c'est nécessaire. Si vous souhaitez échanger sur le sujet avant d'éditer, n'hésitez pas à nous contacter via la liste de diffusion (anglophone) ou notre canal IRC (anglophone).
Écrire une nouvelle définition dans le glossaire (20 minutes)
Clarifier le jargon technique est une bonne méthode pour apprendre et être techniquement précis et clair. Les débutants vous en remercieront. Quelques termes ne sont pas encore définis et ont besoin de vous, choisissez-en un qui vous intéresse et allez-y.
Lire et effectuer une relecture d'un article pédagogique (2 heures)
Cette action ressemble beaucoup à celle de la relecture d'un terme du glossaire (présentée plus haut). Elle demande plus de temps car les articles sont généralement plus longs.
Écrire un nouvel article pour la section Apprendre (4 heures ou plus)
MDN manque de ressources à destination des débutants à propos des technologies web (HTML, CSS, JavaScript, etc.). Certains articles et contenus existent déjà mais ont besoin d'être revus et remaniés. Dépassez vos limites en mettant les technologies web à la portée des débutants.
Créer exercices, exemples de code et outils d'apprentissage interactifs (? heures)
Les différents articles pédagogiques ont besoin d'éléments d'« Apprentissage actif » car chacun apprend mieux en faisant soi-même. Ces éléments peuvent être des exercices ou du contenu interactif qui permette à un utilisateur d'appliquer et de manipuler les concepts détaillés dans un article. De nombreux outils existent pour créer de tels exemples de code : JSFiddle ou similaire pour construire un contenu interactif et avec Thimble, libérez votre créativité !

Je suis un enseignant

MDN est connu pour son excellence sur le plan technique et moins connu, à juste titre, pour son contenu à destination des débutants. C'est là que nous avons besoin de vous, comme enseignant ou formateur. Vous pouvez nous aider à améliorer la pédagogie et la cohérence éducative du contenu du MDN.

Lire et effectuer une relecture d'une définition du glossaire (15 min)
Consultez une des définitions du glossaire et amendez-la si nécessaire. Si vous souhaitez discuter du contenu avant de publier, n'hésitez pas à nous contacter via la liste de diffusion (anglophone) ou notre canal IRC (anglophone).
Écrire une nouvelle définition dans le glossaire (1 heure)
Définir les termes de façon simple et claire pour fournir un aperçu efficace des concepts est essentiel pour s'adresser aux débutants. Votre expérience de pédagogue peut être tout particulièrement utile pour créer un excellent glossaire. De nombreux termes ne sont pas encore définis, choisissez-en un puis allez-y !
Ajouter des illustrations et/ou des schémas à des articles (1 heure)
Comme vous le savez, les illustrations sont indispensables pour apprendre. Or, c'est quelque chose qui manque souvent sur MDN et vos compétences peuvent faire la différence dans ce domaine. Consultez la liste des articles en manque d'illustration et choisissez-en un pour lequel vous souhaitez ajouter des éléments graphiques.
Lire et  effectuer une relecture d'un article pédagogique (2 heures)
Cette action ressemble beaucoup à la relecture d'un terme du glossaire présentée plus haut. Elle prend plus de temps car les articles sont généralement plus longs.
Écrire un nouvel article dans la section « Apprendre » (4 heures)
Cette section a besoin d'articles simples et directs sur le web et les notions fonctionnelles attenantes. Ces articles doivent être écrits dans un but pédagogique : il ne s'agit pas de couvrir l'exhaustivité d'un domaine ou d'un concept mais d'en expliquer l'essentiel. Cet équilibre est difficile à trouver et c'est là que votre expérience toute particulière entre en jeu.
Créer des exercices, des quizz ou des outils d'apprentissage interactifs (? heures)
Les différents articles pédagogiques ont besoin d'éléments de « apprentissage actif » car chacun apprend mieux en faisant soi-même. Ces éléments peuvent être des exercices ou du contenu interactif qui permet à un utilisateur d'appliquer et de manipuler les concepts détaillés dans un article. De nombreux outils existent pour créer de tels exemples : JSFiddle, Thimble. Libérez votre créativité !
Créer des chemins d'apprentissage (? hours)
Afin de fournir des tutoriels progressifs et compréhensibles, les articles doivent être organisés en suites logiques. Cette organisation permet d'utiliser le contenu existant et d'identifier ce qui manque (auquel cas un nouvel article sera le bienvenu).

Rejoignez la communauté Learn

Choisissez votre méthode préférée pour rejoindre la discussion :

Étiquettes et contributeurs liés au document

Contributeurs à cette page : Dralyab, loella16, PetiPandaRou, SphinxKnight
Dernière mise à jour par : Dralyab,