Comment contribuer

Si vous êtes parvenu-e jusqu'à cette page du premier coup ou après avoir longuement cherché, cela signifie probablement que vous souhaitez contribuer à la section « Apprendre » (aussi appelée Learning Area) de MDN. 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.

Trouver une tâche spécifique

L'équipe de contributeurs utilise un tableau Trello pour s'organiser. De cette manière, il est possible de chercher des tâches spécifiques à réaliser sur le projet. Pour participer, créez un compte Trello et envoyez un message à Chris Mills afin qu'il vous donne accès en écriture sur le tableau.

Contribuer représenter également une excellente méthode pour apprendre tout en s'amusant. Si vous vous sentez perdu-e et/ou que vous avez des questions, n'hésitez pas à nous contacter via la liste de diffusion (anglophone) ou notre canal IRC (anglophone) (voir le bas de page pour plus de détails à ce sujet). Chris Mills est le responsable du projet pour la Learning Area — vous pouvez aussi essayer de le contacter directement.

Traduire

Si vous contribuez déjà à MDN, n'hésitez pas à jeter un coup d'œil (voire deux)  à la page de statut de la documentation pour savoir ce qui a été fait et quelles sont les priorités. Si vous souhaitez contribuer à la traduction de cette section en français, la page de statut de localisation vous permettra de connaître l'état des lieux.

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. Si vous utilisez / parcourez / lisez un des articles de cette section et que l'article vous paraît peu clair ou que vous êtes bloqué-e d'une certaine façon, n'hésitez pas à corriger l'article ou à nous contacter pour que nous l'améliorions dès que possible.

Voici quelques façons de contribuer :

Ajouter des étiquettes aux articles (5 min)

Étiqueter le contenu de MDN est la contribution la plus simple qu'il est possible de faire sur MDN. Les étiquettes des articles aident à ajouter du contexte et à améliorer les outils de recherches. Cette fonctionnalité est donc utilisée par de nombreuses fonctionnalité. Et étiqueter un article est une contribution précieuse. Pour commencer, vous pouvez jetez un coup d'œil à la liste des termes du glossaire et aux articles de la section d'apprentissage qui n'ont pas d'étiquette.

Lire et effectuer une relecture d'un terme du glossaire (15 min)

Nous avons besoin de votre regard neuf sur le contenu qui a été rédigé. Si vous trouvez un terme défini dans le glossaire qui est difficile à comprendre, cela signifie qu'il doit être amélioré. N'hésitez pas à apporter les changements que vous estimez nécessaires. Si vous ne pensez pas avoir les compétences pour éditer la page en question, dites-le nous sur la liste de diffusion.

Rédiger une nouvelle définition dans le glossaire (1 heure)

La méthode la plus efficace pour apprendre quelque chose 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 !

Lire et effectuer une relecture d'un article pédagogique (2 heures)

Cela ressemble beaucoup à la relecture d'un terme du glossaire présentée avant. Ça prend 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 de MDN est dédiée à l'apprentissage des concepts du Web et il est donc nécessaire que les explications fournies soient aussi simples que possible (sans tomber non plus dans le pédantisme et la vulgarisation poussée à l'extrême). Il est très important d'être compréhensible, sans tomber dans une foultitude de détails.

Lire et effectuer une relecture d'une définition du glossaire (15 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 (1 heure)

Clarifier le jargon technique est une bonne méthode pour apprendre à être à la fois précis-e sur le plan technique et clair-e sur l'écriture. Plus les définitions seront claires et précises, mieux les débutants pourront en tirer partie. 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)

Cela ressemble beaucoup à la relecture d'un terme du glossaire présentée avant. Ça prend plus de temps car les articles sont généralement plus longs.

Écrire un nouvel article pour la section Apprendre (4 heures)

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 des exercices, des exemples de code et des outils d'apprentissage interactifs (nombre d'heures à déterminer)

Les différents articles pédagogiques ont besoin d'éléments de « pédagogie active » car chacun apprend mieux en faisant quelque chose 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. Faites appel à 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 vous pouvez intervenir. Vous pouvez nous aider à améliorer la pédagogie et la cohérence éducative du contenu de 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 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 (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 un problème que vous pourriez nous aider à résoudre. Consultez la liste des articles en manque d'illustration ou choisissez-en un qui vous intéresse particulièrement puis ajouter les éléments graphiques à la page.

Lire et  effectuer une relecture d'un article pédagogique (2 heures)

Cela ressemble beaucoup à la relecture d'un terme du glossaire présentée avant. Ça 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 l'écosystème du 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 (nombre d'heures à déterminer)

Les différents articles pédagogiques ont besoin d'éléments de « pédagogie active » car chacun apprend mieux en faisant quelque chose 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. Faites appel à 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 différentes séquences. Cela permet d'utiliser le contenu existant et d'identifier ce qui manque (auquel cas un nouvel article sera le bienvenu).