# Comment utiliser l'éditeur (/fr/editor/tutorial)

<!-- agent-signals: reading_time_min: 4 · est_tokens: 1417 · updated: 2026-09-23 -->
Related: [Créer et modifier des pages](/fr/editor/pages.md), [Publier des modifications](/fr/editor/publish.md), [Réviser les modifications](/fr/editor/review.md), [Collaborer dans l'éditeur](/fr/editor/collaborate.md), [Interroger l'agent](/fr/editor/agent.md), [Paramètres de l'éditeur pour l'IA et la publication](/fr/editor/settings.md)

Ce tutoriel vous guide à travers une mise à jour de contenu complète avec l'éditeur. Vous allez créer une branch, faire une modification, partager un aperçu pour révision et publier vos modifications.

<Steps>
  <Step title="Créer une branch">
    Une branch est une copie temporaire de votre contenu. C'est là que vous effectuez vos modifications sans affecter votre site publié. Vous pouvez fusionner une branch dans votre site publié ou l'abandonner en toute sécurité si vous choisissez de ne pas appliquer les modifications.

    Travailler sur une branch permet de garder vos modifications séparées de votre site publié jusqu'à ce que vous soyez prêt à partager le contenu avec vos utilisateurs.

    1. Dans la barre d'outils de l'éditeur, cliquez sur le nom de la branch (généralement `main`, avec un badge **Live**). Si vous ne le voyez pas, [affichez le sélecteur de branch](/fr/editor/publish#show-the-branch-selector).
       <Frame>
         <img src="/_assets/bf51e2362f1e2e0da4fd2b42ec73ef0dfe28e2dac4c23284d0d724f52eecd6b7" alt="Nom de la branch mis en évidence dans la barre d'outils de l'éditeur." className="block dark:hidden" />

         <img src="/_assets/0ba261353886d412e1f0ab56a000d7751e1593e83b19c4328acdb3ba495c5e27" alt="Nom de la branch mis en évidence dans la barre d'outils de l'éditeur." className="hidden dark:block" />
       </Frame>
    2. Dans **Find a branch**, saisissez un titre qui décrit votre modification, comme `Update quickstart`.
    3. Cliquez sur **New branch**.

    L'éditeur bascule vers votre nouvelle branch. Toutes les modifications que vous effectuez ne sont présentes que sur la branch, et elles sont commitées automatiquement sur la branch pendant que vous travaillez. Elles n'apparaissent sur votre site publié que si vous terminez le processus de publication.
  </Step>

  <Step title="Effectuer vos modifications">
    Modifiez une page existante ou créez-en une nouvelle.

    **Pour modifier une page** : Cliquez sur le nom de la page dans la barre latérale de navigation pour l'ouvrir. Tapez directement dans l'éditeur pour ajouter du contenu. Appuyez sur <kbd>/</kbd> pour insérer des composants, des images ou d'autres contenus.

    **Pour créer une page** : Cliquez sur le bouton <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M12.001 5.00003V19.002&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M19.002 12.002L4.99998 12.002&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> plus à côté du group de navigation où vous souhaitez ajouter la page, puis cliquez sur **New page**. Saisissez un titre pour la page. L'éditeur nomme le fichier d'après le titre.

    <Frame>
      <img src="/_assets/848f57ebc752f3850dc57e934252bc9b77001b05f33f941ae611d460b77b0850" alt="Le menu d'ajout de page ouvert à côté d'un group dans l'éditeur." className="block dark:hidden" />

      <img src="/_assets/aa56585168d2faea354b3e46c96fef0e6974c68f4e17d475d1ddab3162fd867a" alt="Le menu d'ajout de page ouvert à côté d'un group dans l'éditeur." className="hidden dark:block" />
    </Frame>
  </Step>

  <Step title="Publier votre branch">
    Lorsque vous modifiez une branch pour la première fois, l'éditeur ouvre une pull request pour elle. Une pull request est une proposition visant à fusionner vos modifications dans la branch qui compile votre site publié. Vos modifications ne sont mises en ligne qu'une fois la pull request fusionnée.

    Lorsque vous êtes prêt pour la révision, demandez-la depuis le menu de publication.

    1. Cliquez sur **Publish** dans la barre d'outils pour ouvrir le menu de publication.
    2. Vous pouvez cliquer sur n'importe quel fichier modifié de la liste pour consulter et comparer vos modifications à la version publiée.
    3. Cliquez sur **Request review**.

    Un [déploiement de prévisualisation](/fr/editor/review#preview-deployments) est compilé pour votre pull request : un lien temporaire où vos modifications s'affichent exactement comme elles apparaîtraient sur votre site publié. Retrouvez l'URL dans le commentaire de pull request du bot Mintlify, et partagez-la avec vos relecteurs.
  </Step>

  <Step title="Faire approuver votre pull request">
    Partagez la pull request avec votre équipe. Pour l'ouvrir, cliquez sur **View request** dans le menu de publication. Les relecteurs peuvent ouvrir la pull request dans GitHub, GitLab ou Bitbucket pour laisser des commentaires, demander des modifications ou l'approuver.

    Si un relecteur demande des modifications, effectuez-les dans l'éditeur sur la même branch. Vos mises à jour sont commitées automatiquement dans la pull request existante. Vous n'avez pas besoin d'en créer une nouvelle.

    Une fois que tous les relecteurs requis ont approuvé, la pull request est prête à être fusionnée.
  </Step>

  <Step title="Fusionner et publier">
    Une fois la pull request approuvée, cliquez sur **Publish** dans la barre d'outils pour rouvrir le menu de publication. Le menu affiche désormais l'état de la pull request et une option pour fusionner.

    Cliquez sur **Merge and publish**. Si Mintlify héberge votre dépôt et qu'aucune approbation n'est requise, le bouton s'appelle **Publish** à la place. L'éditeur fusionne la pull request et vous ramène sur votre deployment branch. Mintlify compile et déploie vos modifications. Votre site publié se met à jour en environ 30 secondes à quelques minutes.
  </Step>
</Steps>