Pour bien débuter

  • Raccourci de la révision : Project:en/Project:Pour_bien_débuter
  • Titre de la révision : Pour bien débuter
  • ID de la révision : 346709
  • Créé :
  • Créateur : Siqo53
  • Version actuelle ? Non
  • Commentaire

Contenu de la révision

{{ MDCProjectPagesTOC() }}

Le réseau de développeur Mozilla (Mozilla Developer Network ou MDN) a des tâches qui peuvent convenir à tous les niveaux de connaissances techniques. Vous n'avez pas besoins d'être programmeur ou de posséder des connaissances approfondies dans la technologie. Nous avons une grande variété de taches à accomplir, du simple (la correction des fautes de frappe et relectures) au complexe (rédaction de document API).

MDN possède une interface web simple qui sera familier à toute personne qui utilise un traitement de texte. S.V.P., aidez-nous! Le succès de MDN est bâti dans un esprit d'entraide par la communauté de Mozillien.

  • Le contenu est plus important que la forme, la grammaire et l'orthographe. Si votre français n'est pas parfait - ne vous en faites pas! Si vous ne mémorisez pas le guide modèle — ne vous en faites pas! Si vous faites une faute — ne vous en faites pas! Les erreurs sont faciles à corriger et les changements peuvent renverser rapidement et facilement.
  • Demander de l'aide et clavarder avec vos nouveaux amis de la communauté MDN. La communauté (les bénévoles et les employés rémunérés) est accueillante. Nous aimons (AIMONS!) les nouveaux collaborateurs! Si vous ne recevez pas une réponse rapide à votre question posée par courriel ou IRC, rappeler vous qu'il y a plusieurs personnes dans différents fuseaux horaires travaillant sur plusieurs projets. N'hésitez pas à demander de l'aide plus d'une fois ou demander à plus d'une personne. Vous n'allez pas être ignoré. Contactez Eric Shepherd, le patron de MDN, si vous ne trouvez pas l’aide dont vous avez besoins. Il n'y a rien de plus important pour nous qu'aider les collaborateurs.
  • Tout le monde peut changer n'importe quoi. Personne ne devrait être contrarié si vous modifiez leurs contenus et vous ne devriez pas être contrarié si quelqu'un modifie vos trucs (cependant, vous êtes libre de poser des questions à propos des changements). Les changements ne sont pas des critiques - ils sont (en grande majorité) des améliorations constructives.
  • Nous avons des meneurs pour des sujets précis. Si vous travaillez dans un sujet spécifique, ces derniers peuvent vous aider.

Guide de démarrage rapide

Identification

MDN utilise Persona comme mode d'identification. Créez-vous un compte Persona et connectez-vous ensuite à MDN.

Entrainement

Entrainer vos habiletés sur les wikis dans le Bac à sable qui se trouve être un endroit spécialement dédié à l'apprentissage et à l’expérimentation du wiki.

Éditer une page

  1. Cliquer sur le bouton « Modifier» en haut de n'importe quelles pages.
  2. Faites vos changements. Cliquez sur « APERÇU DES MODIFICATIONS » pour observer vos changements.
  3. Cliquez sur « ENREGISTRER ET CONTINUER À MODIFIER » pour sauvegarder vos changements sans fermer l'interface d'édition. Cliquer sur « SAUVEGARDÉ LES MODIFICATIONS » pour sauvegarder vos modifications et fermer l'éditeur de texte. Cliquer sur « ANNULÉ LES MODIFICATIONS " pour revenir à la version originale de la page.

You will not be able to save your changes and will get a "Permission Denied" error if your browser has been configured to not send referrer information. If you cannot save your changes, in Firefox, be sure the {{pref("network.http.sendRefererHeader")}} preference is set to its default value (at the moment it's "2").

Create a new page

If you do not know where to put a new article, do not worry about it! Put it anywhere, and we will find it and move it to where it belongs, or merge it into existing content if that makes the most sense. You also do not need to worry about making it perfect. We have happy helper gnomes that will help make your content clean and luscious.

  1. Enter the name of the new page anywhere in the text of a page.
  2. Highlight the name and click the Link icon () in the editor's toolbar. The "Update Link" dialog opens, with the highlighted text in the "Link To" field.
  3. "/en-US/docs/" will be inserted by default at the beginning of the URL field. Enter the name of the page after "/en-US/docs/". (The page name doesn't have to be the same as the link text.)
  4. Click OK to create and insert the link.

If the page does not already exist, the link will be in red. If the page does already exist, the link will be in blue. If you want to create a new page but the page title you want is already taken, check first if it makes more sense to help edit and improve the page that is already there. Otherwise, think of a different title for your new page and create a link for it. Refer to the page naming guide for guidelines.

To add content to your new page, click on the red link you just created (after saving and closing the editor) and start writing. Click "SAVE AND KEEP EDITING" as you work to save your changes without closing the editing interface. Click "SAVE CHANGES" when you are done.

To create a new page without linking from another page, enter a unique page name in the URL field of your browser. For example, if you enter:

https://developer.mozilla.org/en-US/docs/FooBar

... MDN will create a new page with the title "FooBar" and open the editor so you can add content to the new page.

Wiki markup

Kuma, the Mozilla-developed software the Mozilla Developer Network uses, uses HTML as its markup language for the documentation. If you wish to see or edit the HTML content, you can do so by clicking the "Source" button in the toolbar while in edit mode. Click it again to return to the WYSIWYG editor.

Logging documentation bugs

You can report complex problems by filing a documentation bug. Use these field values:

product
Mozilla Developer Network
component
Documentation requests
URL
The page where you found the problem
Description
As much as you know or have time to describe about the problem and where to find correct information. This can include people ("talk to so-and-so") as well as Web links.

Migrating old documentation

One longer ongoing subproject at the MDN is to migrate all currently existing developer documentation from the mozilla.org web site into the MDN wiki. The procedure is fairly simple:

  1. Pick a document you would like to migrate from the existing content list.
  2. Refer to the page naming guide and decide what the page or pages for that document should be called in the wiki.
  3. Create those pages and migrate the content, marking it up as best you can using the wiki markup reference as a guide.
  4. Delete the item from the existing content list.
  5. Add the item to the needs redirect list.

If you are keen on doing a comprehensive job on this, you will also:

  1. Use our search system to search for any links to the original document in the wiki, then change those links so they point at the new wiki page.
  2. Check for external redirects to the original document, and flag those redirects for deletion by adding the "Junk" tag to them.

Localizing MDN

If you are interested in helping translate the documentation in any of the MDN wikis to another language, simply visit the relevant language's wiki and create or edit pages. See Localization projects for information about current projects and how to start a new project.

Resolving "edit wars" or other conflicts

If for whatever reason you end up in an "edit war" on a page, where two or more people are continually and repeatedly making and reverting changes, please try to resolve the conflict with the people involved first.

Should no resolution be possible, please bring it to the attention of either (ideally) the MDN mailing list or (as a last resort) the developer documentation lead. Other technical experts, writers, and editors will be consulted as required, and their expertise will be used to resolve the problem.

Requesting page deletions

Should you create a page by accident or stumble across a page you think should be deleted, mark it as such by adding the "Junk" tag to it.

Items tagged as Junk are checked periodically by wiki administrators and the pages it contains are evaluated and deleted when appropriate.

Note: Please do not delete other content or categories from the pages you flag as "Junk".

Source de la révision

<p>{{ MDCProjectPagesTOC() }}</p>
<p>Le réseau de développeur Mozilla (Mozilla Developer Network ou MDN) a des tâches qui peuvent convenir à tous les niveaux de connaissances techniques. Vous n'avez pas besoins d'être programmeur ou de posséder des connaissances approfondies dans la technologie. Nous avons une grande variété de taches à accomplir, du simple (la correction des fautes de frappe et relectures) au complexe (rédaction de document API).</p>
<p>MDN possède une interface web simple qui sera familier à toute personne qui utilise un traitement de texte. <strong>S.V.P., aidez-nous! </strong>Le succès de MDN est bâti dans un esprit d'entraide par la <a href="/en-US/docs/Project:Community" title="/en-US/docs/Project:Community">communauté</a> de <span class="brand">Mozillien</span>.</p>
<ul>
  <li><strong>Le contenu est plus important que la forme, la grammaire et l'orthographe. </strong>Si votre français n'est pas parfait - ne vous en faites pas! Si vous ne mémorisez pas le <a href="/en-US/docs/Project:MDC_style_guide" title="/en-US/docs/Project:MDC_style_guide">guide modèle</a> — ne vous en faites pas! Si vous faites une faute — ne vous en faites pas! Les erreurs sont faciles à corriger et les changements peuvent renverser rapidement et facilement.</li>
  <li><strong>Demander de l'aide et clavarder avec vos nouveaux amis de la communauté MDN.</strong> La <a href="/en-US/docs/Project:Community" title="/en-US/docs/Project:Community">communauté</a> (les bénévoles et les employés rémunérés) est accueillante. Nous aimons (AIMONS!) les nouveaux collaborateurs! Si vous ne recevez pas une réponse rapide à votre question posée par courriel ou IRC, rappeler vous qu'il y a plusieurs personnes dans différents fuseaux horaires travaillant sur plusieurs projets. N'hésitez pas à demander de l'aide plus d'une fois ou demander à plus d'une personne. Vous n'allez pas être ignoré. Contactez <a class="link-mailto" href="mailto:eshepherd@mozilla.com">Eric Shepherd</a>, le patron de MDN, si vous ne trouvez pas l’aide dont vous avez besoins. Il n'y a rien de plus important pour nous qu'aider les collaborateurs.</li>
  <li><strong>Tout le monde peut changer n'importe quoi.</strong> Personne ne devrait être contrarié si vous modifiez leurs contenus et vous ne devriez pas être contrarié si quelqu'un modifie vos trucs (cependant, vous êtes libre de poser des questions à propos des changements). Les changements ne sont pas des critiques - ils sont (en grande majorité) des améliorations constructives.</li>
  <li><strong>Nous avons des <a href="/Project:en/Topic_drivers" title="Project:en/Topic_drivers">meneurs pour des sujets précis</a>.</strong> Si vous travaillez dans un sujet spécifique, ces derniers peuvent vous aider.</li>
</ul>
<h2 id="Guide_de_d.C3.A9marrage_rapide">Guide de démarrage rapide</h2>
<h3 id="Identification">Identification</h3>
<p>MDN utilise <a class="external" href="http://www.persona.org/" title="http://www.persona.org/">Persona</a> comme mode d'identification. Créez-vous un compte Persona et connectez-vous ensuite à MDN.</p>
<h3 id="Entrainement">Entrainement</h3>
<p>Entrainer vos habiletés sur les wikis dans le <a href="https://developer.mozilla.org/en-US/docs/Sandbox" title="Sandbox: An area of the wiki for experiments">Bac à sable</a> qui se trouve être un endroit spécialement dédié à l'apprentissage et à l’expérimentation du wiki.</p>
<h3 id=".C3.89diter_une_page">Éditer une page</h3>
<ol>
  <li>Cliquer sur le bouton « Modifier» en haut de n'importe quelles pages.</li>
  <li>Faites vos changements. Cliquez sur « APERÇU DES MODIFICATIONS » pour observer vos changements.</li>
  <li>Cliquez sur « ENREGISTRER ET CONTINUER À MODIFIER » pour sauvegarder vos changements sans fermer l'interface d'édition. Cliquer sur « SAUVEGARDÉ LES MODIFICATIONS » pour sauvegarder vos modifications et fermer l'éditeur de texte. Cliquer sur « ANNULÉ LES MODIFICATIONS " pour revenir à la version originale de la page.</li>
</ol>
<div class="note">
  <p>You will not be able to save your changes and will get a "Permission Denied" error if your browser has been configured to not send referrer information. If you cannot save your changes, in Firefox, be sure the {{pref("network.http.sendRefererHeader")}} preference is set to its default value (at the moment it's "2").</p>
</div>
<h3 id="Create_a_new_page">Create a new page</h3>
<p>If you do not know where to put a new article, <strong>do not worry about it!</strong> Put it anywhere, and we will find it and move it to where it belongs, or merge it into existing content if that makes the most sense. You also do not need to worry about making it perfect. We have happy helper gnomes that will help make your content clean and luscious.</p>
<h4 id="Link_from_an_existing_page">Link from an existing page</h4>
<ol>
  <li>Enter the name of the new page anywhere in the text of a page.</li>
  <li>Highlight the name and click the Link icon (<img alt="" src="/files/3810/link-icon.png" style="width: 29px; height: 28px;" />) in the editor's toolbar. The "Update Link" dialog opens, with the highlighted text in the "Link To" field.</li>
  <li>"/en-US/docs/" will be inserted by default at the beginning of the URL field. Enter the name of the page after "/en-US/docs/". (The page name doesn't have to be the same as the link text.)</li>
  <li>Click OK to create and insert the link.</li>
</ol>
<p>If the page does not already exist, the link will be in red. If the page <em>does</em> already exist, the link will be in blue. If you want to create a new page but the page title you want is already taken, check first if it makes more sense to help edit and improve the page that is already there. Otherwise, think of a different title for your new page and create a link for it. Refer to the <a href="/Project:en/Page_Naming_Guide" title="Project:en/Page_Naming_Guide">page naming guide</a> for guidelines.</p>
<p>To add content to your new page, click on the red link you just created (after saving and closing the editor) and start writing. Click "SAVE AND KEEP EDITING" as you work to save your changes without closing the editing interface. Click "SAVE CHANGES" when you are done.</p>
<h4 id="New_page_without_link">New page without link</h4>
<p>To create a new page without linking from another page, enter a unique page name in the URL field of your browser. For example, if you enter:</p>
<pre>
https://developer.mozilla.org/en-US/docs/FooBar</pre>
<p>... MDN will create a new page with the title "FooBar" and open the editor so you can add content to the new page.</p>
<h4 id="Wiki_markup">Wiki markup</h4>
<p><a href="https://github.com/mozilla/kuma" title="https://github.com/mozilla/kuma">Kuma</a>, the Mozilla-developed software the Mozilla Developer Network uses, uses HTML as its markup language for the documentation. If you wish to see or edit the HTML content, you can do so by clicking the "Source" button in the toolbar while in edit mode. Click it again to return to the WYSIWYG editor.</p>
<h2 id="Logging_documentation_bugs">Logging documentation bugs</h2>
<p>You can report complex problems by <a class="external" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla%20Developer%20Network">filing a documentation bug</a>. Use these field values:</p>
<dl>
  <dt>
    product</dt>
  <dd>
    Mozilla Developer Network</dd>
  <dt>
    component</dt>
  <dd>
    Documentation requests</dd>
  <dt>
    URL</dt>
  <dd>
    The page where you found the problem</dd>
  <dt>
    Description</dt>
  <dd>
    As much as you know or have time to describe about the problem and where to find correct information. This can include people ("talk to so-and-so") as well as Web links.</dd>
</dl>
<h2 id="Migrating_old_documentation">Migrating old documentation</h2>
<p>One longer ongoing subproject at the MDN is to migrate all currently existing developer documentation from the <a class="external" href="http://www.mozilla.org">mozilla.org</a> web site into the MDN wiki. The procedure is fairly simple:</p>
<ol>
  <li>Pick a document you would like to migrate from the <a href="/Project:en/Existing_Content" title="Project:en/Existing_Content">existing content</a> list.</li>
  <li>Refer to the <a href="/Project:en/Page_Naming_Guide" title="Project:en/Page_Naming_Guide">page naming guide</a> and decide what the page or pages for that document should be called in the wiki.</li>
  <li>Create those pages and migrate the content, marking it up as best you can using the <a href="/Project:En/MDC_style_guide" title="Project:en/Wiki_Markup_Reference">wiki markup reference</a> as a guide.</li>
  <li>Delete the item from the <a href="/Project:en/Existing_Content" title="Project:en/Existing_Content">existing content</a> list.</li>
  <li>Add the item to the <a href="/Project:en/Needs_Redirect" title="Project:en/Needs_Redirect">needs redirect</a> list.</li>
</ol>
<p>If you are keen on doing a comprehensive job on this, you will also:</p>
<ol>
  <li>Use <a href="/Special:Search" title="Search">our search system</a> to search for any links to the original document in the wiki, then change those links so they point at the new wiki page.</li>
  <li>Check for <a href="/Project:en/External_Redirects" title="Project:en/External_Redirects">external redirects</a> to the original document, and flag those redirects for deletion by adding the "Junk" tag to them.</li>
</ol>
<h2 id="Localizing_MDN">Localizing MDN</h2>
<p>If you are interested in helping translate the documentation in any of the MDN wikis to another language, simply visit the relevant language's wiki and create or edit pages. See <a href="/en-US/docs/Project:Localization_Projects" title="/en-US/docs/Project:Localization_Projects">Localization projects</a> for information about current projects and how to start a new project.</p>
<h2 id="Resolving_.22edit_wars.22_or_other_conflicts">Resolving "edit wars" or other conflicts</h2>
<p>If for whatever reason you end up in an "edit war" on a page, where two or more people are continually and repeatedly making and reverting changes, please try to resolve the conflict with the people involved first.</p>
<p>Should no resolution be possible, please bring it to the attention of either (ideally) the <a href="/Project:en/Community" title="Project:en/Community">MDN mailing list</a> or (as a last resort) the <a href="/User:Sheppy" title="User:Sheppy">developer documentation lead</a>. Other technical experts, writers, and editors will be consulted as required, and their expertise will be used to resolve the problem.</p>
<h2 id="Requesting_page_deletions">Requesting page deletions</h2>
<p>Should you create a page by accident or stumble across a page you think should be deleted, mark it as such by adding the "Junk" tag to it.</p>
<p>Items tagged as <a class="internal" href="https://developer.mozilla.org/en-US/docs/tag/junk" title="Special:Tags?tag=Junk">Junk</a> are checked periodically by wiki administrators and the pages it contains are evaluated and deleted when appropriate.</p>
<div class="note">
  <strong>Note</strong>: Please do not delete other content or categories from the pages you flag as "Junk".</div>
Revenir à cette révision