Rédaction de contenu

Il y a toujours des choses qui peuvent être ajoutées ou mises à jour sur le MDN. Que ce soit une toute nouvelle documentation pour une nouvelle API brillante ou la révision d'une ancienne API qui a changé subtilement, vous trouverez beaucoup de possibilités pour aider.

Modifier une page existante

Si vous avez trouvé une page que vous souhaitez réviser, cliquez simplement sur le bouton « Modifier » dans le coin supérieur droit. Cela ouvrira l'éditeur WYSIWYG pour travailler sur le contenu de la page. Consultez le guide de l'éditeur MDN pour plus de détails sur la façon de travailler avec l'éditeur, ainsi que la façon de travailler avec le système macro que nous utilisons pour aider à automatiser la construction et la mise en forme du contenu.

Il y a de nombreuses raisons qui peuvent vous pousser à modifier une page existante :

• Vous avez repéré une erreur ou une faute de frappe.
• Vous voulez reformuler quelque chose pour rendre le texte plus compréhensible.
• La mise en page ou le formatage de la page est en désordre.
• L'API documentée a changé et la documentation doit être actualisée pour correspondre aux changements.
• Vous souhaitez ajouter des informations sur une différence de comportement entre plusieurs navigateurs pour une API.
• Vous voulez ajouter ou améliorer un exemple de code. Voir Add a code sample ci-dessous pour plus de détails.
• L'article est une ébauche, ou bien il manque des détails importants.

Ajouter une nouvelle page

Voici le grand défi ! Ajouter une nouvelle page de MDN permet de construire le Web que vous aimez tant et que vous voulez étreindre. Il existe plusieurs raisons évidentes pour créer une nouvelle page, comme documenter une API qui n'est pas encore documentée ou pour ajouter un nouveau tutoriel ou un guide sur un sujet.

Il y a plusieurs manières d'aller sur la création d'une nouvelle page sur MDN, une fois que vous êtes connecté:

Cliquez sur le lien "page manquante"

Lorsque vous naviguez sur MDN, vous aurez l'occasion de trouver des liens vers des pages qui n'existent pas encore. Souvent, lorsque nous créons des articles, nous incluons des liens vers des pages qui doivent être créées, même si elles ne sont pas encore réalisées. Cela nous aide à garder une trace des choses qui doivent éventuellement être faites, bien que parfois il faille un certain temps pour revenir à elles. Vous devriez vous sentir libre de le faire! Il suffit de cliquer sur ces liens et vous serez redirigé directement dans l'éditeur de la nouvelle page.

Créer une sous-page

Près du coin supérieur droit de chaque article, il y a un menu déroulant "Avancé". Dans ce menu, il y a une option "Nouvelle sous-page". En cliquant sur cette option, elle ouvre l'éditeur de page pour la création d'une nouvelle page dont la page parente dans la hiérarchie du site est la page sur laquelle vous avez choisi "Nouvelle sous-page". Il suffit de définir le titre et de commencer à écrire le contenu de l'article.

Créer un clone

Vous pouvez également cloner une page existante en utilisant l'option "Cloner cette page" dans le menu déroulant "Cette page". En cliquant sur cette option, elle crée une copie de la page en cours, dont la page parent est identique à la page en cours, et ouvre l'éditeur sur cette page, où vous pouvez définir le titre de la page, ainsi que modifier le contenu de la page. Ceci est généralement un bon moyen d'ajouter une nouvelle page à une zone de référence existante du site, par exemple, parce qu'il vous procure une mise en page de l'échantillon pour le contenu.

Créer un lien vers une page qui n'existe pas, puis cliquer dessus

Ceci est un peu une méthode hybride. Etant donné que chaque page doit être liée à partir d'une source, vous pourriez commencer par créer un lien vers le nouvel article en l'ajoutant à une page existante, puis, après avoir sauvé cette page, vous pouvez cliquer sur le lien que vous venez d'insérer pour ouvrir un éditeur pour le nouvel article.

Trouver l'information

Il y a beaucoup d'informations un peu partout, et il peut être difficile de trouver l'aide dont vous avez besoin. Voici quelques conseils pour vous aider à démarrer.

Liste des propriétaire des Modules

Les projets Mozilla travaillent sur une base "de propriétaire de module"; chaque composant majeur a un propriétaire ou des propriétaires qui sont responsables de ce qui se passe là-bas. Ces propriétaires sont souvent la meilleure source d'informations - ou au moins un excellent moyen de trouver la bonne personne à qui parler.

Mozilla source cross-reference

MXR, le Mozilla cross-reference, vous permet d'accéder à tout le code source pour le projet Mozilla (à l'exception de certaines choses, comme le projet Firefox OS, qui est situé sur GitHub). Le code et ses commentaires sont souvent une excellente source d'informations.

Mozilla wiki

Le wiki de Mozilla - souvent désigné comme "wikimo" - est un référentiel de processus et de conception de notes, projets, plans et devis préliminaires. En dépit d'être souvent un désordre encombré, il est un trésor de renseignements précieux.