> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-docs-automation-github-pr-review.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide

> Commencez avec Mintlify : déployez votre site de documentation en quelques minutes et faites votre première modification via l'éditeur web ou Git.

Après avoir terminé ce guide, vous disposerez d'un site de documentation en ligne prêt à être personnalisé et mis à jour.

<div id="before-you-begin">
  ## Avant de commencer
</div>

Mintlify utilise une approche *docs-as-code* pour gérer votre documentation. Chaque page de votre site possède un fichier correspondant, stocké dans votre <Tooltip tip="Le code source de votre documentation où tous les fichiers et leur historique sont stockés. L'éditeur web se connecte à votre référentiel de documentation pour accéder au contenu et le modifier, ou vous pouvez modifier les fichiers localement dans votre IDE préféré.">référentiel</Tooltip> de documentation.

Lorsque vous connectez votre référentiel de documentation à votre projet, vous pouvez travailler sur votre documentation localement ou dans l'éditeur web et synchroniser toutes les modifications avec votre référentiel distant.

<Tip>
  Vous utilisez un outil de développement assisté par IA ?

  Copiez l'invite suivante pour ajouter la [skill](/fr/ai/skillmd) et le [serveur MCP](/fr/ai/model-context-protocol) Mintlify afin d'obtenir de meilleurs résultats lors de la mise à jour de votre documentation.
</Tip>

<Prompt
  description="Installez la skill Mintlify pour obtenir le contexte sur la structure d'un projet Mintlify, ses composants et les bonnes pratiques de documentation :

npx skills add https://mintlify.com/docs

Ajoutez ensuite le serveur MCP Mintlify pour accéder à la recherche dans la documentation. Suivez les instructions de configuration sur https://www.mintlify.com/docs/ai/model-context-protocol.md"
  actions={["copy", "cursor"]}
>
  Installez la skill Mintlify pour obtenir le contexte sur la structure d'un projet Mintlify, ses composants et les bonnes pratiques de documentation :

  npx skills add [https://mintlify.com/docs](https://mintlify.com/docs)

  Ajoutez ensuite le serveur MCP Mintlify pour accéder à la recherche dans la documentation. Suivez les instructions de configuration sur [https://www.mintlify.com/docs/ai/model-context-protocol.md](https://www.mintlify.com/docs/ai/model-context-protocol.md)
</Prompt>

<div id="deploy-your-documentation-site">
  ## Déployer votre site de documentation
</div>

Accédez à [mintlify.com/start](https://mintlify.com/start) et suivez le processus d'onboarding. Pendant l'onboarding, vous connectez votre compte GitHub, créez ou sélectionnez un référentiel pour votre documentation et installez la GitHub App afin d'activer les déploiements automatiques.

Après l'onboarding, votre site de documentation est déployé et accessible via l'URL `.mintlify.site` de votre site.

<AccordionGroup>
  <Accordion title="Facultatif : ignorer la connexion d'un fournisseur Git pendant l'onboarding">
    Si vous souhaitez démarrer rapidement sans connecter votre propre référentiel, vous pouvez ignorer la connexion du fournisseur Git pendant l'onboarding. Mintlify crée un référentiel privé dans une organisation privée et configure automatiquement la GitHub App pour vous.

    Cela vous permet d'utiliser immédiatement l'éditeur web. Si vous souhaitez utiliser votre propre référentiel plus tard, accédez à [Git Settings](https://dashboard.mintlify.com/settings/deployment/git-settings) dans votre Dashboard pour migrer votre contenu à l'aide de l'assistant de configuration Git. Voir [Cloner dans votre propre référentiel](/fr/deploy/github#clone-to-your-own-repository) pour plus de détails.
  </Accordion>
</AccordionGroup>

<div id="view-your-deployed-site">
  ## Voir votre site déployé
</div>

Votre site de documentation est maintenant déployé à l’adresse `https://<your-project-name>.mintlify.site`.

Trouvez l’URL exacte de votre site sur la page **Overview** de votre [Tableau de bord Mintlify](https://dashboard.mintlify.com/).

<Frame>
  <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/XpTZ81chTFZOX5fm/images/quickstart/mintlify-domain-light.png?fit=max&auto=format&n=XpTZ81chTFZOX5fm&q=85&s=afd62a0890d275385861ac7f1ce128b5" alt="Page Overview du Tableau de bord Mintlify." className="block dark:hidden" width="3024" height="1372" data-path="images/quickstart/mintlify-domain-light.png" />

  <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/QBTK2PGeDDpdhDBw/images/quickstart/mintlify-domain-dark.png?fit=max&auto=format&n=QBTK2PGeDDpdhDBw&q=85&s=b37ee32999553ee796865272e75554e7" alt="Page Overview du Tableau de bord Mintlify." className="hidden dark:block" width="3008" height="1368" data-path="images/quickstart/mintlify-domain-dark.png" />
</Frame>

<Tip>
  Votre site est immédiatement prêt à être consulté. Utilisez cette URL pour effectuer des tests et la partager avec votre équipe. Avant de le partager avec vos utilisateurs, vous voudrez peut-être ajouter un [domaine personnalisé](/fr/customize/custom-domain).
</Tip>

<div id="make-your-first-change">
  ## Effectuer votre première modification
</div>

<Tabs>
  <Tab title="CLI">
    <Steps>
      <Step title="Installer la CLI">
        La CLI nécessite [Node.js](https://nodejs.org/en) v20.17.0 ou une version supérieure. Utilisez une version LTS pour plus de stabilité.

        <CodeGroup>
          ```bash npm theme={null}
          npm i -g mint
          ```

          ```bash pnpm theme={null}
          pnpm add -g mint
          ```
        </CodeGroup>

        Consultez [Installer la CLI](/fr/cli/install) pour plus de détails et de conseils de dépannage.
      </Step>

      <Step title="Cloner votre référentiel Git">
        Si vous n’avez pas encore cloné votre référentiel Git en local, clonez-le avec Git :

        ```bash theme={null}
        git clone <your-repository-url>
        ```

        Si votre référentiel se trouve dans l’organisation privée de Mintlify, consultez [Cloner dans votre propre référentiel](/fr/deploy/github#clone-to-your-own-repository) pour le déplacer d’abord vers votre compte.
      </Step>

      <Step title="Modifier une page">
        Ouvrez `index.mdx` dans votre éditeur préféré et modifiez la description dans le frontmatter :

        ```mdx theme={null}
        ---
        title: "Introduction"
        description: "Votre description personnalisée ici"
        ---
        ```
      </Step>

      <Step title="Prévisualiser en local">
        Exécutez la commande suivante depuis votre répertoire de documentation :

        ```bash theme={null}
        mint dev
        ```

        Affichez l’aperçu à l’adresse `http://localhost:3000`.
      </Step>

      <Step title="Pousser vos modifications">
        Effectuez un commit puis poussez vos modifications pour déclencher un déploiement :

        ```bash theme={null}
        git add .
        git commit -m "Update description"
        git push
        ```

        Mintlify déploie automatiquement vos modifications. Consultez l’état du déploiement sur la page [Overview](https://dashboard.mintlify.com/) de votre Dashboard.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Éditeur web">
    <Steps>
      <Step title="Ouvrir l’éditeur web">
        Accédez à l’[éditeur web](https://dashboard.mintlify.com/editor) depuis votre Dashboard.
      </Step>

      <Step title="Modifier une page">
        Ouvrez la page **Introduction** et mettez à jour la description.

        <Frame>
          <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/QBTK2PGeDDpdhDBw/images/quickstart/hello-world-light.png?fit=max&auto=format&n=QBTK2PGeDDpdhDBw&q=85&s=416860462f4a80c8ba1a1aeae1982ee1" alt="Page Introduction ouverte dans l’éditeur web avec la description modifiée pour afficher Hello world!." className="block dark:hidden" width="1622" height="402" data-path="images/quickstart/hello-world-light.png" />

          <img src="https://mintcdn.com/mintlify-docs-automation-github-pr-review/QBTK2PGeDDpdhDBw/images/quickstart/hello-world-dark.png?fit=max&auto=format&n=QBTK2PGeDDpdhDBw&q=85&s=931687c69df5a84e675423ebc1cd448f" alt="Page Introduction ouverte dans l’éditeur web avec la description modifiée pour afficher Hello world!." className="hidden dark:block" width="1624" height="404" data-path="images/quickstart/hello-world-dark.png" />
        </Frame>
      </Step>

      <Step title="Publier">
        Cliquez sur le bouton **Publish** en haut à droite de la barre d’outils de l’éditeur web.
      </Step>

      <Step title="Afficher en ligne">
        Sur la page [Overview](https://dashboard.mintlify.com/) de votre Dashboard, vous pouvez voir l’état de déploiement de votre site. Une fois le déploiement terminé, actualisez votre site de documentation pour voir vos modifications en ligne.
      </Step>
    </Steps>
  </Tab>
</Tabs>

<div id="next-steps">
  ## Prochaines étapes
</div>

<Card title="Utiliser l’éditeur web" icon="mouse-pointer-2" horizontal href="/fr/editor/index">
  Modifiez la documentation dans votre navigateur et prévisualisez l’apparence de vos pages lorsqu’elles sont publiées.
</Card>

<Card title="Explorer les commandes CLI" icon="terminal" horizontal href="/fr/cli/index">
  Repérez les liens brisés, vérifiez l’accessibilité, validez les spécifications OpenAPI et bien plus encore.
</Card>

<Card title="Ajouter un domaine personnalisé" icon="globe" horizontal href="/fr/customize/custom-domain">
  Utilisez votre propre domaine pour votre site de documentation.
</Card>