Aider les débutants à apprendre sur MDN !

Nos pages Apprendre le développement web obtiennent plus d'un million de vues par mois, et ont des forums actifs où les utilisateurs vont 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.

De quoi avons-nous besoin ?

Dans le forum d'apprentissage du MDN, il existe deux principaux types de messages auxquels nous aimerions que vous nous aidiez à répondre :

  1. Questions générales sur le développement web.
  2. Questions spécifiques demandant de l'aide ou une évaluation des tests de compétences et des évaluations qui figurent dans la section Apprendre le développement web de MDN.

Comment pouvez-vous en profiter ?

  • Aider les gens à résoudre leurs problèmes de code est un excellent moyen d'en apprendre davantage sur les technologies web. En recherchant une solution et en rédigeant une réponse à la question de quelqu'un, vous approfondirez votre compréhension du sujet et améliorerez vos compétences.
  • Au fur et à mesure que vous vous impliquerez dans la communauté MDN, vous apprendrez à connaître le personnel de Mozilla et les autres membres de la communauté, ce qui vous donnera un réseau de contacts précieux pour obtenir de l'aide sur vos propres problèmes et accroître votre visibilité.
  • Aider à répondre à des questions de codage est en grande partie une récompense en soi, mais cela démontrera également votre expertise dans les technologies web et peut-être même vous aidera dans votre cours, ou dans vos opportunités d'emploi.

Quelles sont les compétences dont vous avez besoin ?

  • Vous devez avoir une bonne connaissance des technologies web telles que HTML, CSS et JavaScript. Idéalement, vous devez aussi savoir expliquer des sujets techniques et aimer aider les débutants à apprendre à coder.
  • La langue du forum est l'anglais - vous devriez avoir une maîtrise raisonnable de la langue anglaise, mais il n'est pas nécessaire qu'elle soit parfaite. Des gens du monde entier visitent nos forums, et nous voulons que tous ceux qui nous rendent visite se sentent aussi à l'aise et inclus que possible.

Comment aider

  1. Tout d'abord, créez-vous un compte MDN, si vous n'en avez pas déjà un. Vous n'avez pas nécessairement besoin de le faire pour contribuer à l'espace d'apprentissage, mais cela vous sera utile à long terme.
  2. Inscrivez-vous également à Mozilla Discourse, si ce n'est pas déjà fait.
  3. Jetez un coup d'œil à la section Apprendre le développement web et acquérez un niveau de familiarité de base avec ce qui s'y trouve, si ce n'est pas déjà fait (voir la section Structure de l'espace d'apprentissage MDN ci-dessous pour vous aider).

Une fois que vous êtes prêt

  1. Jetez un coup d'œil au forum d'apprentissage et voyez s'il y a des messages qui n'ont pas de réponses - c'est le meilleur endroit pour commencer.

    • Conseil : si vous ne trouvez aucune réponse, consultez les autres pages qui ont été récemment mises à jour et voyez si vous pouvez ajouter quelque chose d'utile qui n'a pas déjà été dit.

  2. Si le message auquel vous répondez est une demande d'aide générale, répondez-lui et donnez-lui autant d'aide que vous en avez le temps.

  3. Si le message auquel vous répondez demande une évaluation pour l'une des tâches "tester vos compétences"/"évaluation" :

    1. Identifiez l'article/tâche évalué(e) et trouvez le guide de notation qui lui est associé. Vous pouvez tout à fait demander à la personne qui a envoyé le message si elle peut vous donner le lien vers l'évaluation/le test de compétences.

    2. Identifiez le code de la personne - elle devrait vous le donner sous la forme d'un lien CodePen/JSFiddle/JSBin, ou similaire. Si elle ne le fournit pas sous une forme facile à évaluer, il est parfaitement acceptable de lui demander de le mettre dans CodePen, JSFiddle, ou similaire.

      • Un problème courant est celui des personnes qui publient leur code directement dans un message de discourse - discourse rend les éléments HTML et transforme les guillemets en smartquotes, ce qui casse le code. Il est préférable de l'envoyer sous forme d'URL vers une application d'édition de code partageable.

    3. Lisez le code et évaluez-le

      1. Est-ce qu'il fonctionne, et vous donne-t-il le résultat qu'il devrait donner ?
      2. Si non, pourquoi ne fonctionne-t-il pas ?
      3. Avez-vous des conseils à donner à la personne pour améliorer le code (plus efficace, meilleure pratique, etc.) ?

    4. Donnez-leur un rapport sur leurs résultats :

      1. Certains guides de notation suggèrent un schéma de notation avec des points pour chaque partie de la question, mais vous n'avez pas besoin d'être aussi précis.
      2. Si la personne s'est bien débrouillée, à l'exception de quelques détails, dites-lui ces détails, mais félicitez-la aussi.
      3. Si la personne était sur le point d'atteindre son objectif, mais que son travail n'était pas tout à fait correct, dites-lui qu'elle s'est très bien débrouillée, mais indiquez-lui les corrections à apporter pour que cela fonctionne, et peut-être même un lien vers le guide de notation pour qu'elle puisse voir ce que nous avons fait.
      4. Si la personne est loin d'avoir trouvé une solution, soyez gentil et encourageant et essayez de lui donner quelques indices sur la direction à prendre. Donnez-lui une autre chance d'essayer de faire mieux.
      5. Si vous avez besoin d'aide pour quoi que ce soit, demandez de l'aide dans le salon de discussion MDN Web Docs sur Matrix.

Attention : Avant tout, soyez patient, amical et aimable. N'oubliez pas que la plupart de ces personnes sont des débutants.

Structure de l'espace d'apprentissage MDN

Lorsque vous aidez à répondre aux questions liées à la section Apprendre le développement web de MDN, il est bon d'y jeter un coup d'œil et d'acquérir un niveau de familiarité de base avec ce qui s'y trouve.

  1. Examinez la structure de la page en général.

  2. Regardez en particulier les types d'évaluations disponibles,

  3. Jetez un œil aux dépôts GitHub associés à la zone d'apprentissage (la plupart des fichiers sont disponibles dans https://github.com/mdn/learning-area/, certains sont dans https://github.com/mdn/css-examples/tree/master/learn). La plupart des exemples sur lesquels les apprenants voudront de l'aide sont contenus ici.

  4. Chaque évaluation/épreuve de compétence est associée à un guide de notation et à une solution recommandée pour vous aider à évaluer leur travail.

  5. Il existe des modèles qui facilitent la recherche de ces ressources, par exemple :

Il vous semblera difficile de naviguer dans tout cela au début, mais vous trouverez cela plus facile avec le temps, à mesure que vous vous familiariserez avec les exercices.