# Guides (/fr/guides)

<!-- agent-signals: reading_time_min: 5 · est_tokens: 2430 · updated: 2026-07-30 -->

Les guides de cette section contiennent des conseils pour créer une documentation qui permet à vos utilisateurs de réussir. Que vous partiez de zéro ou que vous amélioriez une documentation existante, ces guides vous aident à planifier, rédiger et maintenir votre documentation.

Par-dessus tout, prenez en compte les besoins et les objectifs de vos utilisateurs. Documentez ce qui les aide à utiliser votre produit et à reprendre rapidement leurs tâches.

<div id="topics">
  ## Rubriques [#rubriques]
</div>

<div id="ai-tools">
  ### Outils d'IA [#outils-dia]
</div>

Utilisez des outils d'IA pour accélérer votre flux de travail de documentation.

* [Build an in-app assistant](/fr/guides/assistant-embed) : tutoriel qui explique comment ajouter un chatbot IA dans une application React pour aider les utilisateurs à trouver des réponses dans votre documentation.
* [Configurer l'automerge](/fr/guides/configure-automerge) : ajoutez l'application GitHub Mintlify à la liste de contournement d'un ensemble de règles pour activer la fusion automatique pour les automatisations.
* [Utiliser les automatisations](/fr/guides/use-automations) : choisissez le bon déclencheur d'automatisation, rédigez des instructions efficaces et obtenez des résultats cohérents grâce à la maintenance de contenu automatisée.
* [Claude Code](/fr/guides/claude-code), [Codex](/fr/guides/codex), [Cursor](/fr/guides/cursor), [Devin Desktop](/fr/guides/devin-desktop) : guides pour utiliser des assistants de programmation IA afin de maintenir la documentation.
* [GEO](/fr/guides/geo) : bonnes pratiques pour optimiser votre documentation pour les moteurs de recherche et de réponse basés sur l'IA.

<div id="api-documentation">
  ### Documentation d'API [#documentation-dapi]
</div>

Créez une documentation d'API qui permet aux utilisateurs de tester et d'apprendre à utiliser votre API, tout en étant facile à maintenir.

* [Migrer de MDX vers OAS](/fr/guides/migrating-from-mdx): Migrez votre documentation d'API depuis des pages MDX individuelles vers des pages générées automatiquement à partir d'une spécification OpenAPI.

<div id="best-practices">
  ### Bonnes pratiques [#bonnes-pratiques]
</div>

Faites de votre documentation une référence.

* [Accessibilité](/fr/guides/accessibility): Rendez votre documentation accessible au plus grand nombre possible.
* [Types de contenu](/fr/guides/content-types): Choisissez le bon format pour les tutoriels, guides pratiques, références et explications.
* [Modèles de contenu](/fr/guides/content-templates): Dupliquez et adaptez des modèles pour chaque type de contenu.
* [Mises en page personnalisées](/fr/guides/custom-layouts): Utilisez les modes de page et les composants pour créer des pages de destination et d'autres mises en page personnalisées.
* [Améliorer votre documentation](/fr/guides/improving-docs): Utilisez les données et les retours pour améliorer continuellement votre documentation.
* [Internationalisation](/fr/guides/internationalization): Configurez une documentation multilingue pour atteindre une audience mondiale.
* [Liens](/fr/guides/linking) : Créez des liens internes, référencez des points de terminaison d'API et garantissez l’intégrité des liens dans toute votre documentation.
* [Maintenance](/fr/guides/maintenance): Gardez votre documentation précise et à jour.
* [Médias](/fr/guides/media): Ajoutez des images, des vidéos et d’autres médias de manière efficace tout en maîtrisant la charge de maintenance.
* [Organiser la navigation](/fr/guides/navigation): Concevez une architecture de l’information adaptée à vos utilisateurs.
* [SEO](/fr/guides/seo): Optimisez votre documentation pour les moteurs de recherche.
* [Style et ton](/fr/guides/style-and-tone): Écrivez avec un ton cohérent.
* [Comprendre votre audience](/fr/guides/understand-your-audience): Étudiez les besoins et objectifs de vos utilisateurs et répondez-y.

<div id="git-workflows">
  ### Flux de travail Git [#flux-de-travail-git]
</div>

Comprenez Git pour tirer le meilleur parti de Mintlify et d'une approche « docs-as-code » de la documentation.

* [Concepts de Git](/fr/guides/git-concepts) : Apprenez les fondamentaux de Git pour la documentation.
* [Branches](/fr/guides/branches) : Utilisez des branches pour gérer les modifications de la documentation.

<div id="use-cases">
  ### Cas d’utilisation [#cas-dutilisation]
</div>

Découvrez comment Mintlify répond à différents cas d’utilisation et trouvez une solution adaptée à vos besoins.

* [Créer une documentation développeur](/fr/guides/developer-documentation) : Aidez vos utilisateurs à tirer le meilleur parti de votre produit ou de votre API grâce à une documentation développeur qui répond à leurs questions et leur permet de revenir rapidement à leurs tâches principales.
* [Créer une base de connaissances](/fr/guides/knowledge-base) : configurez une base de connaissances interne pour centraliser les informations de votre équipe, améliorer la recherche et réduire la charge de maintenance.
* [Créer un centre d’aide](/fr/guides/help-center) : Créez un centre d’aide en libre-service qui permet aux utilisateurs de trouver des réponses par eux-mêmes, réduit le volume de tickets et améliore la satisfaction client.
* [Créer un frontend personnalisé](/fr/guides/custom-frontend) : utilisez l’intégration Mintlify Astro pour afficher votre documentation avec un frontend entièrement personnalisé.

<div id="where-to-start">
  ## Par où commencer [#par-où-commencer]
</div>

<CardGroup cols="2">
  <Card title="Vous débutez avec la documentation ?" 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;M8 10.1667L12.1232 6.04344C13.2481 4.91858 13.8105 4.35614 14.4312 3.90314C15.7047 2.9737 17.1818 2.36187 18.7395 2.11858C19.4988 2 20.2942 2 21.885 2C21.9681 2 22 2.03812 22 2.11504C22 3.70584 22 4.50125 21.8814 5.26046C21.6381 6.81818 21.0263 8.29527 20.0969 9.56878C19.6439 10.1895 19.0814 10.7519 17.9566 11.8768L13.8333 16&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M10.341 8.09838C8.63808 8.09838 6.49778 7.73765 4.9043 8.39769C3.73671 8.88132 2.87754 10.0012 2 10.8787L5.30597 12.2955C6.18208 12.671 5.64651 13.7766 5.50147 14.5018C5.33985 15.3099 5.34886 15.3397 5.93158 15.9224L8.07758 18.0684C8.6603 18.6511 8.69008 18.6602 9.49816 18.4985C10.2234 18.3535 11.329 17.8179 11.7044 18.694L13.1213 22C13.9988 21.1225 15.1187 20.2633 15.6023 19.0957C16.2624 17.5022 15.9016 15.3619 15.9016 13.659&#x22; stroke=&#x22;currentColor&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M12 20L11 21&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M4 12L3 13&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M15 4.07996C16.2 4.25996 17.46 4.73996 18.1614 5.45996C19.0576 6.25211 19.68 7.31996 19.92 8.99996&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;square&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M17.94 6.06006L16.5 7.50006&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/fr/guides/content-types">
    Découvrez les types de contenu pour comprendre comment structurer votre documentation.
  </Card>

  <Card title="Vous améliorez une documentation existante ?" 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;M7 15.2461L9.87381 11.5319C10.1242 11.2082 10.2495 11.0464 10.3862 10.9354C10.7975 10.6017 11.3471 10.5135 11.8368 10.7026C11.9997 10.7654 12.1664 10.8804 12.5 11.1103C12.8336 11.3402 13.0003 11.4552 13.1632 11.518C13.6529 11.7071 14.2025 11.6189 14.6138 11.2852C14.7505 11.1742 14.8757 11.0124 15.1262 10.6887L15.9061 9.68068C16.8833 8.41772 17.3719 7.78624 18.0414 7.7479C18.7109 7.70956 19.264 8.28139 20.3701 9.42505L21 10.0764&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M21 21H10C6.70017 21 5.05025 21 4.02513 19.9749C3 18.9497 3 17.2998 3 14V3&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/fr/guides/improving-docs">
    Découvrez comment utiliser les indicateurs et les retours pour améliorer votre documentation.
  </Card>

  <Card title="Vous travaillez en équipe ?" 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;M7 20C8.10457 20 9 19.1046 9 18C9 16.8954 8.10457 16 7 16C5.89543 16 5 16.8954 5 18C5 19.1046 5.89543 20 7 20Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M7 8C8.10457 8 9 7.10457 9 6C9 4.89543 8.10457 4 7 4C5.89543 4 5 4.89543 5 6C5 7.10457 5.89543 8 7 8Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M17 14C18.1046 14 19 13.1046 19 12C19 10.8954 18.1046 10 17 10C15.8954 10 15 10.8954 15 12C15 13.1046 15.8954 14 17 14Z&#x22; stroke=&#x22;currentColor&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M7.02116 8.2793V15.4073M14.4113 12.0047L10.0193 12.0048C8.92158 12.0048 6.86182 11.1254 7.01818 8.78001&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/fr/guides/git-concepts">
    Apprenez les workflows Git pour une documentation collaborative.
  </Card>
</CardGroup>