diff options
Diffstat (limited to 'files/fr/mdn/contribute/getting_started/index.html')
| -rw-r--r-- | files/fr/mdn/contribute/getting_started/index.html | 107 |
1 files changed, 28 insertions, 79 deletions
diff --git a/files/fr/mdn/contribute/getting_started/index.html b/files/fr/mdn/contribute/getting_started/index.html index 6e5309b57e..bb6f7dcf96 100644 --- a/files/fr/mdn/contribute/getting_started/index.html +++ b/files/fr/mdn/contribute/getting_started/index.html @@ -2,109 +2,58 @@ title: Débuter sur MDN slug: MDN/Contribute/Getting_started tags: - - Débutant + - Documentation + - Getting Started - Guide - - Introduction - MDN - - MDN Meta + - MDN Project + - New Contributors translation_of: MDN/Contribute/Getting_started --- -<div>{{MDNSidebar}}</div><div>{{IncludeSubnav("/fr/docs/MDN")}}</div> +<div>{{MDNSidebar}}</div> -<p>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 toute contribution est la bienvenue. Ensemble nous pouvons continuer à innover sur le Web et aider tous ses utilisateurs. Ça commence ici, avec vous.</p> +<p class="summary">Nous sommes une communauté ouverte de développeuses et développeurs qui créent des ressources pour un meilleur Web, quelle que soit la marque, le navigateur ou la plate-forme. Tout le monde peut contribuer et chaque personne qui le fait nous rend plus forts. Ensemble, nous pouvons continuer à stimuler l'innovation sur le Web pour servir le bien commun. Cela commence ici, avec vous.</p> -<p>Chaque composant de MDN (les documents, les démonstrations, le site lui-même) est créé par une communauté ouverte : rejoignez-la !</p> +<p>Chaque partie de MDN (documents, démos et le site lui-même) est créée par une communauté ouverte de développeuses et développeurs. Rejoignez-nous !</p> -<h2 id="3_étapes_pour_contribuer_à_MDN">3 étapes pour contribuer à MDN</h2> +<h2 id="4_simple_steps_to_MDN">4 étapes simples vers MDN</h2> -<p>MDN est un wiki : <strong>n'importe qui</strong> peut ajouter et éditer du contenu. Il n'est pas nécessaire d'être développeur ou de s'y connaître beaucoup en technologie, il y a tellement de choses à faire ! Des choses simples — <em>comme la relecture ou la correction typographique</em> — ou des choses plus complexes — <em>comme la rédaction de la documentation d'une API</em>.</p> +<p>MDN est une ressource open source où <strong>toute personne</strong> peut ajouter et modifier des contenus. Il n'est pas nécessaire d'être un programmeur ou d'en savoir beaucoup sur les technologies. Il y a beaucoup de choses à faire, des plus simples (relecture et correction de fautes de frappe) aux plus complexes (rédaction de la documentation des API).</p> -<p>Contribuer est facile et sans risque. Si vous faites une erreur, il sera facile de la corriger. Si vous n'êtes pas 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 personnes ici dont la tâche est de garantir la qualité du contenu de MDN. Il y aura donc toujours quelqu'un pour s'assurer que votre travail est valide. Partagez juste vos connaissances et suivez vos points forts : faites confiance au reste de la communauté pour améliorer encore votre travail.</p> +<p>Contribuer est facile et sûr. Même si vous faites une erreur, elle est facilement corrigée. Même si vous ne savez pas exactement comment les choses doivent être présentées, ou si votre grammaire n'est pas très bonne, ne vous inquiétez pas ! Nous avons une équipe de personnes dont le travail consiste à s'assurer que le contenu de MDN est aussi bon que possible. Quelqu'un sera là pour s'assurer que votre travail est soigné et bien écrit. Partagez ce que vous savez et suivez vos points forts.</p> -<h3 id="Étape_1_créer_un_compte_sur_MDN">Étape 1 : créer un compte sur MDN</h3> +<h3>Étape 1 : Créer un compte GitHub</h3> -<p>Pour commencer à contribuer sur MDN, il est nécessaire d'avoir un compte. Pour plus de détails à ce sujet : <a href="/fr/docs/MDN/Contribute/Howto/Comment_créer_un_compte_sur_MDN">comment créer un compte</a>. Notez que vous aurez besoin d'un compte GitHub avant de pouvoir créer un compte sur MDN, car nous utilisons actuellement GitHub pour l'authentification.</p> +<p>Pour commencer vos contributions à MDN, vous devez <a href="https://github.com/mdn/content/#setup">créer un compte GitHub</a>.</p> -<p>Si vous avez besoin de créer de nouvelles pages, consultez <a href="/fr/docs/Project:MDN/contribuer/Créer_et_modifier_des_pages#Créer_une_nouvelle_page" title="Dès que vous avez obtenu les droits de création de page, vous pouvez créer de nouvelles pages.">Créer une page</a> pour savoir comment obtenir la permission d'exécuter cette opération. Pour des raisons de sécurité, les nouveaux comptes ne peuvent pas créer de nouvelles pages.</p> -<h3 id="Étape_2_choisir_une_tâche">Étape 2 : choisir une tâche</h3> +<h3 id="Step_2_Pick_a_task_to_complete">Étape 2 : Choisir une tâche à accomplir</h3> -<p>Une fois connecté, vous pouvez lire les descriptions des tâches proposées ci-dessous et choisir celle que vous souhaitez réaliser. Choisissez celle qui vous attire le plus pour commencer à contribuer !</p> +<p>Maintenant que vous êtes connecté, lisez les descriptions des différents types de tâches disponibles sur la <a href="/fr/docs/MDN/Contribute">page relative aux contributions</a>, et décidez de celle qui vous attire le plus. Vous pouvez choisir la tâche qui vous convient et commencer à contribuer.</p> -<h3 id="Étape_3_effectuer_cette_tâche">Étape 3 : effectuer cette tâche</h3> +<h3 id="Step_3_Do_the_task">Étape 3 : Effectuer la tâche</h3> -<p>Une fois que vous avez choisi un type de tâche, vous pouvez trouver une page, un exemple de code, etc. sur quoi travailler.</p> +<p>Une fois que vous avez décidé du type de tâche que vous voulez accomplir, trouvez une page spécifique, un exemple de code, etc. sur lequel travailler, et faites-le !</p> -<p>Ne vous inquiétez pas si cela n'est pas parfait ; d'autres contributeurs MDN sont ici pour aider à corriger les erreurs qui pourraient vous échapper. Si vous avez des questions, jetez un œil sur la page <a href="/fr/docs/MDN/Rejoindre_la_communauté">Rejoindre la communauté</a> où vous trouverez les listes de diffusion et les salons de discussions où vous pourrez trouver des réponses.</p> +<h3 id="Step_4_Ask_for_help">Étape 4 : Demander de l'aide</h3> -<div class="note"> -<p><strong>Note :</strong> Si vous voulez faire des expériences avant de faire une modification « pour de vrai », vous pouvez éditer la page <a href="/fr/docs/Sandbox">Bac à sable</a>. 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.</p> -</div> - -<p>Une fois que c'est fait, choisissez-en une autre ou voyez ce que vous pouvez faire d'autre sur MDN.</p> - -<h2 id="Les_différents_types_de_tâches">Les différents types de tâches</h2> - -<p>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.</p> - -<h3 id="Option_1_jaime_lire_écrire…">Option 1 : j'aime lire, écrire…</h3> - -<p>Vous pouvez nous aider à relire ou éditer certains articles et également les étiqueter (« <em>tagger</em> ») pour qu'ils soient mieux triés.</p> - -<ul> - <li><a href="/fr/docs/MDN/Contribute/Howto/Set_the_summary_for_a_page">Rédiger le résumé d’une page </a>(5 à 15 minutes)</li> - <li><a href="/fr/docs/MDN/Contribute/Howto/faire_relecture_redactionnelle">Effectuer une relecture rédactionnelle</a> (5 à 30 minutes)</li> - <li><a href="/fr/docs/MDN/Contribute/Howto/Write_a_new_entry_in_the_Glossary">Écrire un nouvel article pour le glossaire</a> (15 minutes à 1 heure)</li> - <li><a href="/fr/docs/MDN/Contribute/Howto/Write_an_article_to_help_learn_about_the_Web">Écrire un article pour aider les personnes qui souhaitent apprendre le Web</a> (1 à 3 heures)</li> -</ul> - -<div class="note"><strong>Note :</strong> Si vous relisez ou écrivez de nouveaux articles, veuillez lire le <a href="/fr/docs/MDN/Contribute/Guidelines/Writing_style_guide">guide de mise en forme (en anglais)</a>. Cela permettra de s'assurer que l'ensemble des articles est cohérent.</div> - -<h3 id="Option_2_jaime_coder">Option 2 : j'aime coder</h3> - -<p>Nous avons besoin davantage d'exemples de codes ! Vous pouvez également contribuer à la plate-forme du site : <a href="https://github.com/mozilla/kuma">Kuma</a>.</p> +<p>Si vous n'êtes pas sûr de ce que vous devez faire à un moment donné, vous pouvez demander de l'aide. Il existe plusieurs options d'aide :</p> <ul> - <li><a href="/fr/docs/MDN/Contribute/Howto/convertir_code_pour_etre_direct">Convertir des exemples de codes en exemples « live »</a> (30 minutes)</li> - <li><a href="https://wiki.mozilla.org/Webdev/GetInvolved/developer.mozilla.org">Lire le guide de contribution (en anglais)</a> (30 minutes)</li> - <li><a href="http://kuma.readthedocs.org/en/latest/installation.html">Mettre en place votre environnement Kuma (explications en anglais)</a> (1 heure)</li> - <li><a href="https://github.com/mozilla/kuma#readme">Soumettre un patch pour Kuma (explications en anglais)</a> (1 heure)</li> + <li>Si vous voulez nous parler de manière synchrone et poser des questions sur MDN lui-même, rejoignez la discussion sur le salon de discussion <a href="https://chat.mozilla.org/#/room/#l10n-fr:mozilla.org">Localisation / traduction en français</a> sur <a href="https://wiki.mozilla.org/Matrix">Matrix</a>.</li> + <li>Vous pouvez également nous envoyer un e-mail à <a href="mailto:mdn-admins@mozilla.org">mdn-admins@mozilla.org</a>.</li> + <li>Si vous apprenez le développement web et êtes bloqué sur un problème de codage, nous avons des <a href="https://discourse.mozilla.org/c/mdn/learn/250">forums actifs</a> où vous pouvez poser des questions et obtenir de l'aide.</li> </ul> -<h3 id="Option_3_jaime_coder_mais_aussi_écrire">Option 3 : j'aime coder mais aussi écrire</h3> - -<p>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.</p> - -<ul> - <li><a href="/fr/docs/MDN/Contribute/Howto/Étiquettes_pages_JavaScript">Étiqueter les pages JavaScript</a> (5 minutes)</li> - <li><a href="/fr/docs/MDN/Promotion_de_MDN">Promouvoir MDN sur votre propre site</a> (5 minutes)</li> - <li><a href="/fr/docs/MDN/Contribute/Howto/faire_relecture_technique">Effectuer une relecture technique</a> (30 minutes)</li> - <li><a href="/fr/docs/Project:MDN/contribuer/Créer_et_modifier_des_pages#Cr.C3.A9er_une_nouvelle_page">Écrire un nouvel article sur un sujet que vous connaissez</a> (1 heure ou plus)</li> - <li><a href="/fr/docs/Contribute_to_docs_that_are_currently_needed">Écrire un article sur un sujet qui doit être couvert</a> (1 heure ou plus)</li> - <li><a href="/fr/docs/MDN/Contribute/Howto/Create_an_interactive_exercise_to_help_learning_the_web">Créer un exercice interactif pour aider les débutants à apprendre le Web</a> (1 heure ou plus)</li> -</ul> - -<h3 id="Option_4_je_veux_que_MDN_soit_traduit">Option 4 : je veux que MDN soit traduit</h3> - -<p>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.</p> - -<ul> - <li><a href="/fr/docs/MDN/Contribute/Localize/Translating_pages">Traduire des pages</a> (2 heures) (voir <a href="/fr/docs/MDN/Doc_status/l10nPriority">les pages prioritaires</a>)</li> - <li>Se connecter avec d'autres traducteurs listés dans <a href="/fr/docs/Project:Projets_de_localisation">les projets de traduction</a> (30 minutes)</li> -</ul> - -<h3 id="Option_5_jai_trouvé_une_information_incorrecte_mais_je_ne_sais_pas_comment_la_corriger">Option 5 : j'ai trouvé une information incorrecte mais je ne sais pas comment la corriger</h3> - -<p>Vous pouvez rapporter des problèmes en remplissant <a class="external" href="https://bugzilla.mozilla.org/form.doc">une fiche de bogue</a>. (5 minutes)</p> - -<p>Les valeurs à utiliser sont :</p> +<p>Ne vous souciez pas de le faire parfaitement ; d'autres contributeurs MDN sont là pour aider à corriger les erreurs qui se glissent.</p> -<div class="note"><strong>Note:</strong> les fiches de bogue sont à remplir en anglais. Si jamais vous souhaitez indiquer votre correction en français, la meilleure façon est de vous connecter sur #mozfr sur IRC ou bien d'envoyer un courriel à moz-fr [à] mozfr.org.</div> +<h2 id="useful_complete_beginners_guides">Guides complets et utiles pour les débutants</h2> -<h2 id="Les_autres_choses_à_faire_sur_MDN">Les autres choses à faire sur MDN</h2> +<p>Nous attendons des contributeurs à MDN qu'ils aient un certain nombre de connaissances préalables avant de commencer à travailler sur le contenu. Si les sujets suivants vous sont inconnus, nous vous conseillons de consulter les liens fournis pour vous aider à vous mettre à niveau :</p> <ul> - <li><a href="/fr/docs/MDN/Rejoindre_la_communauté">Rejoindre la communauté MDN</a>.</li> - <li><a href="/fr/profile">Remplir son profil</a> afin que les autres utilisateurs puissent mieux vous connaître.</li> - <li>Lire d'autres documents sur comment <a href="/fr/docs/MDN/Contribute">contribuer à MDN</a>.</li> + <li>Technologies web : Si vous êtes novice en HTML, CSS, JavaScript, etc., consultez nos tutoriels pour <a href="/fr/docs/Learn">Apprendre le développement web</a>.</li> + <li>Open source : Si vous n'avez jamais contribué à un projet open source, lisez <a href="/fr/docs/MDN/Contribuer/Open_source_etiquette">L'étiquette de base des projets open source</a>.</li> + <li>Git et GitHub : Si vous n'êtes pas familier avec ces outils, <a href="/fr/docs/MDN/Contribute/GitHub_beginners">GitHub pour les grands débutants</a> vous permettra de démarrer. Vous pouvez également consulter <a href="https://tech.mozfr.org/post/2021/03/16/MDN-sur-GitHub-comment-contribuer">ce billet sur les contributions à MDN avec Git.</a></li> + <li>Les structures de dépôt de MDN : Si vous ne savez pas quels dépôts modifier pour apporter des modifications aux différentes parties du contenu de MDN, <a href="/fr/docs/MDN/Contribute/Where_is_everything">Où se trouve tout sur MDN ?</a> vous orientera vers les bons endroits.</li> </ul> |