Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

Pour bien débuter

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 besoin d'être programmeur ou de posséder des connaissances approfondies en technologie. Nous avons une grande variété de tâches à 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 familière à 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 Mozilliens.

  • 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 être inversés 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, rappelez-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 besoin. 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.

Entraînement

Entraîner 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.

Édition d'une page

  1. Cliquez sur le bouton « Modifier » en haut de n'importe quelle page.
  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 « SAUVEGARDER LES MODIFICATIONS » pour sauvegarder vos modifications et fermer l'éditeur de texte. Cliquer sur « ANNULER LES MODIFICATIONS » pour revenir à la version originale de la page.

Vous ne serez pas en mesure d'enregistrer vos modifications et obtiendrez une erreur "Autorisation refusée" si votre navigateur a été configuré pour ne pas envoyer des informations de provenance. Si vous ne pouvez pas enregistrer vos modifications, dans Firefox, assurez-vous que la préférence {{pref("network.http.sendRefererHeader")}} est réglée sur sa valeur par défaut ("2" pour le moment).

Création d'une nouvelle page

Si vous ne savez pas où mettre un nouvel article, ne vous inquiétez pas ! Mettez-le n'importe où, et nous le trouverons et de le déplacerons au bon endroit, ou le fusionnerons avec du contenu existant si cela à plus de sens. Vous n'avez pas non plus besoin de vous inquiéter de le rendre parfait. Nous avons des assistants gnomes qui vous aideront volontiers à rendre votre contenu propre et succulent.

Lien à partir d'une page existante

  1. Entrez le nom de la nouvelle page n'importe où dans le texte d'une page.
  2. Mettez le nom en surbrillance et cliquez sur l'icône Lien () dans la barre d'outils d'édition. La boîte de dialogue "Mettre à jour le lien" s'ouvre, avec le texte en surbrillance dans le champ "Link to".
  3. "/en-US/docs/" sera inséré par défaut au début du champ URL. Entrez le nom de la page après "/en-US/docs/". (Le nom de la page ne ​​doit pas être le même que le texte du lien.)
  4. Cliquez sur OK pour créer et insérer le lien.

Si la page n'existe pas encore, le lien sera en rouge. Si la page existe déjà, le lien sera en bleu. Si vous voulez créer une nouvelle page, mais que le titre de la page que vous voulez est déjà pris, vérifiez d'abord si ce n'est pas plus logique d'éditer et améliorer la page qui est déjà là. Sinon, pensez à un autre titre pour votre nouvelle page et créez un lien pour ce titre. Reportez-vous au guide de nommage des pages pour des directives précises.

Pour ajouter du contenu à votre nouvelle page, cliquez sur le lien rouge que vous venez de créer (après l'enregistrement et la fermeture de l'éditeur) et commencez à écrire. Cliquez sur "SAUVEGARDER ET CONTINUER A EDITER" pendant que vous travaillez pour enregistrer vos modifications sans fermer l'interface d'édition. Cliquez sur "ENREGISTRER LES MODIFICATIONS" lorsque vous avez terminé.

Nouvelle page sans lien

Pour créer une nouvelle page sans lien avec une autre page, entrez un nom de page unique dans le champ URL de votre navigateur. Par exemple, si vous entrez :

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

... MDN va créer une nouvelle page avec le titre "FooBar" et va ouvrir l'éditeur de sorte que vous pourrez ajouter du contenu à la nouvelle page.

Le balisage Wiki

Kuma, le logiciel développé par Mozilla que le MDN utilise, utilise le HTML comme langage de balisage pour la documentation. Si vous désirez voir ou modifier le contenu HTML, vous pouvez le faire en cliquant sur le bouton "Source" dans la barre d'outils en mode édition. Cliquez à nouveau sur ce bouton pour revenir à l'éditeur WYSIWYG.

Référencement des bugs dans la documentation

Vous pouvez signaler des problèmes complexes en remplissant une documentation de bug. Utilisez ces valeurs de champ :

produit
Mozilla Developer Network
composant
Demandes de documentation
URL
La page où vous avez trouvé le problème
Description
Autant que vous savez ou avez le temps de d'écrire sur le problème et où trouver l'information correcte. Il peut s'agir de personnes («talk to so-and-so") ainsi que de liens Web.

Migration de documentation ancienne

Un sous-projet en cours au MDN est de migrer toute la documentation des développeurs existant actuellement sur ​​le site Web mozilla.org dans le wiki MDN. La procédure est assez simple :

  1. Choisissez un document que vous souhaitez déplacer à partir de la liste du contenu existant.
  2. Reportez-vous au guide de nommage des pages et décidez comment nommer la ou les pages de ce document dans le wiki.
  3. Créez ces pages and migrez leur contenu, en le marquant du mieux que vous pouvez en utilisant la référence des balises wiki comme guide.
  4. Supprimez l'élément de la liste du contenu existant.
  5. Ajoutez l'élément à la liste needs redirect.

Si vous avez envie de faire un travail complet sur ​​ce point, vous pouvez aussi :

  1. Utilisez notre système de recherche pour trouver des liens pointant vers le document original dans le wiki, puis modifier ces liens pour qu'ils pointent sur ​​la nouvelle page wiki.
  2. Vérifiez les redirections externes au document d'origine, et signalez ces redirections pour la suppression en ajoutant le tag "Junk".

Localisation du MDN

Si aider à traduire la documentation de l'un des wikis MDN dans une autre langue vous intéresse, il suffit de visiter le wiki de la langue concernée et de créer ou modifier les pages. Voir la page Localization projects pour plus d'informations sur les projets actuels et la façon de démarrer un nouveau projet.

Résolution des "guerres d'édition" ou autres conflits

Si pour une raison quelconque vous vous retrouvez dans une "guerre d'édition" sur une page, qui survient lorsque deux ou plusieurs personnes sont en permanence et de manière répétitive en train de faire et d'inverser des changements, essayez s'il vous plaît de résoudre le conflit avec les personnes concernées en premier lieu.

Si aucune résolution n'était possible, veuillez contacter (idéalement) la liste de diffusion MDN ou (en dernier recours), le developer documentation lead. D'autres experts techniques, rédacteurs et éditeurs seront consultés au besoin, et leur expertise sera utilisée pour résoudre le problème.

Demande de suppression de page

Si vous créez une page par accident ou tombez sur une page qui devrait être supprimée selon vous, marquez-la comme tel par l'ajout du tag "Junk".

Les articles taggés comme
Junk sont contrôlés régulièrement par les administrateurs du wiki et les pages qu'ils contiennent sont évaluées et supprimées le cas échéant.

Note : Merci de ne pas supprimer du contenu ou des catégories des pages que vous signalez comme "indésirables".

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : Jeremie, Beatrice, Siqo53
 Dernière mise à jour par : Jeremie,