From 2a41c9c3d9c4660702c31bb68562958ecb44ee3e Mon Sep 17 00:00:00 2001 From: tristantheb Date: Tue, 25 May 2021 20:47:40 +0200 Subject: L10N: Update the MDN Guideline (important pages only) with Yari and Git/GitHub (#371) * UPDATE: Code guideline page is now up-to-date from the US version * CREATE: Add the general code guildeline page * CREATE: Add the CSS code guideline page * CREATE: Add the HTML code guideline page * FIX: Fix some elements on pages * CREATE: Add the JavaScript code guideline page * Pre-Creaate english version of other Guildelines pages * L10N: Update translation of the Javascript code guildeline page * L10N: Update translation of the Shell code guildeline page * FIX: Add missing class on the Code Guideline * UPDATE: Up-to-date the Feedback page * UPDATE: Up-to-date the Getting started page * L10N: Translate the Github for beginners page * UPDATE: Update indexes of Guideline and Contribute * L10N: Translation of the two Github additional guide pages * L10N: Translation of the Help for beginners page * L10N: Translation of the Localize page * L10N: Translation of the Open_source_etiquette rules * UPDATE: Remove wrong html element and update title for Processes page * L10N: Translation of the Where is everything page * L10N: Important translation of the Documentation priorities page * Meta - Review priority * Meta - Review feedback * Meta - Review Getting started * Review - minor edits * Review - minor typos * Review - few rewordings * Review - minor rewordings * Review - minor lint * Review - Consistency with MDN vs le MDN * Review - update / ko / link ks * Review - minor rewordings * Review - Complement since no subpage * Review - minor typo * Review - rm cssxref * Review - minor fixes * Review - minor fixes * Review - minor fixes * Review - minor fixes * Review - minor fixes * Review - Complete translation of doc * Review - Complete translation * Review - complete translation * Review - complete translation * Review - minor rewording * Review - Complete translation * Review - Localization of style guide in Fr Co-authored-by: julieng --- files/fr/mdn/contribute/help_beginners/index.html | 112 ++++++++++++++++++++++ 1 file changed, 112 insertions(+) create mode 100644 files/fr/mdn/contribute/help_beginners/index.html (limited to 'files/fr/mdn/contribute/help_beginners') diff --git a/files/fr/mdn/contribute/help_beginners/index.html b/files/fr/mdn/contribute/help_beginners/index.html new file mode 100644 index 0000000000..bf5fe31886 --- /dev/null +++ b/files/fr/mdn/contribute/help_beginners/index.html @@ -0,0 +1,112 @@ +--- +title: Aider les débutants à apprendre sur MDN ! +slug: MDN/Contribute/Help_beginners +tags: + - Beginner + - Contribute + - HELP + - Learning + - MDN +translation_of: MDN/Contribute/Help_beginners +--- +

{{MDNSidebar}}

+ +

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. +
  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.
    3. +
+ +

Comment pouvez-vous en profiter ?

+ + + +

Quelles sont les compétences dont vous avez besoin ?

+ + + +

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. +
  2. Inscrivez-vous également à Mozilla Discourse, si ce n'est pas déjà fait.
    3. +
  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).
    4. +
+ +

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. +
  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. +
  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. +
    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. +
    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. +
      2. Si non, pourquoi ne fonctionne-t-il pas ?
        3. +
      3. Avez-vous des conseils à donner à la personne pour améliorer le code (plus efficace, meilleure pratique, etc.) ?
        4. +
      +
      4. +
    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. +
      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. +
      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. +
      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. +
      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.
        6. +
      +
      5. +
    +
    4. +
+ +
+

Important :

+

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. +
  2. Regardez en particulier les types d'évaluations disponibles, + +
    3. +
  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. +
  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. +
  5. Il existe des modèles qui facilitent la recherche de ces ressources, par exemple : + +
    6. +
+ +

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.

-- cgit v1.2.3-54-g00ecf