> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-add-hello-world-quickstart-48843.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Journal des modifications

> Publiez des mises à jour produit dans vos docs avec un flux RSS auquel s’abonner

Créez un journal des modifications pour vos docs en ajoutant des [composants de mise à jour](/fr/components/update) à une page.

Consultez le [journal des modifications de Mintlify](/fr/changelog) comme exemple : vous pouvez inclure des liens, des images, du texte et des démonstrations de vos nouvelles fonctionnalités dans chaque mise à jour.

<div id="setting-up-your-changelog">
  ## Configuration de votre journal des modifications
</div>

<Steps>
  <Step title="Créer une page pour votre journal des modifications">
    1. Créez une nouvelle page dans votre documentation, par exemple `changelog.mdx` ou `updates.mdx`.
    2. Ajoutez la page de journal des modifications à votre schéma de navigation dans votre `docs.json`.
  </Step>

  <Step title="Ajouter des composants Update à votre journal des modifications">
    Ajoutez un `Update` pour chaque entrée du journal des modifications.

    Incluez des informations pertinentes comme des nouvelles fonctionnalités, des corrections de bugs ou d’autres annonces.
  </Step>
</Steps>

```mdx Exemple de changelog.mdx
---
title: "Journal des modifications"
description: "Mises à jour produit et annonces"
---
<Update label="Mars 2025" description="v0.0.10">
  Ajout d’un nouveau parfum Wintergreen.

  Nouvelle version du parfum Spearmint, désormais avec 10 % de menthe en plus.
</Update>

<Update label="Février 2025" description="v0.0.09">
  Nouvelle version du parfum Spearmint.
</Update>
```

<div id="customizing-your-changelog">
  ## Personnaliser votre journal des modifications
</div>

Contrôlez la façon dont les utilisateurs parcourent votre journal des modifications et restent informés des nouveautés de votre produit.

<div id="table-of-contents">
  ### Table des matières
</div>

Chaque propriété `label` d’un `Update` crée automatiquement une entrée dans la table des matières de la barre latérale droite. Il s’agit de la navigation par défaut de votre journal des modifications.

<Frame>
  <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/K9uomxeMDdJnUp_m/images/changelog-toc-light.png?fit=max&auto=format&n=K9uomxeMDdJnUp_m&q=85&s=95a8e0d0cbbe0abbc59270dba19b0b2c" alt="Journal des modifications avec table des matières affichée en mode clair." className="block dark:hidden" width="2632" height="1502" data-path="images/changelog-toc-light.png" />

  <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/K9uomxeMDdJnUp_m/images/changelog-toc-dark.png?fit=max&auto=format&n=K9uomxeMDdJnUp_m&q=85&s=69c8a77ab966221c7bb8020a95a54fd0" alt="Journal des modifications avec table des matières affichée en mode sombre." className="hidden dark:block" width="2590" height="1432" data-path="images/changelog-toc-dark.png" />
</Frame>

<div id="tag-filters">
  ### Filtres par tags
</div>

Ajoutez des `tags` à vos composants `Update` pour remplacer la table des matières par des filtres par tags. Les utilisateurs peuvent filtrer le journal des modifications en sélectionnant un ou plusieurs tags :

```mdx Exemple d’habillage des filtres de tags
<Update label="Mars 2025" description="v0.0.10" tags={["Wintergreen", "Spearmint"]}>
  Ajout d’une nouvelle saveur Wintergreen.

  Nouvelle version de la saveur Spearmint, désormais avec 10 % de menthe en plus.
</Update>

<Update label="Février 2025" description="v0.0.09" tags={["Spearmint"]}>
  Nouvelle version de la saveur Spearmint.
</Update>

<Update label="Janvier 2025" description="v0.0.08" tags={["Peppermint", "Spearmint"]}>
  Saveur Peppermint dépréciée.

  Nouvelle version de la saveur Spearmint.
</Update>
```

<Frame>
  <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/K9uomxeMDdJnUp_m/images/changelog-filters-light.png?fit=max&auto=format&n=K9uomxeMDdJnUp_m&q=85&s=178e1f3c02f9deef9bad12ddb97376ff" alt="Journal des modifications en mode clair avec le filtre de tag Peppermint sélectionné." className="block dark:hidden" width="2170" height="582" data-path="images/changelog-filters-light.png" />

  <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/K9uomxeMDdJnUp_m/images/changelog-filters-dark.png?fit=max&auto=format&n=K9uomxeMDdJnUp_m&q=85&s=bb16954a05f01ea8aebc141ff477fe8a" alt="Journal des modifications en mode sombre avec le filtre de tag Peppermint sélectionné." className="hidden dark:block" width="2172" height="584" data-path="images/changelog-filters-dark.png" />
</Frame>

<Tip>
  La table des matières et les filtres du journal des modifications sont masqués lorsque vous utilisez les modes de page `custom`, `center` ou `wide`. En savoir plus sur les [modes de page](/fr/pages#page-mode).
</Tip>

<div id="subscribable-changelogs">
  ### Journaux des modifications abonnables
</div>

L’utilisation des composants `Update` crée un flux RSS auquel on peut s’abonner à l’URL de votre page avec `/rss.xml` ajouté. Par exemple, `mintlify.com/docs/changelog/rss.xml`.

Des entrées sont ajoutées au flux RSS lorsque de nouveaux composants `Update` sont publiés et lorsque de nouveaux titres sont ajoutés à l’intérieur des balises `<Update>` existantes.

Les titres de niveau supérieur des composants `Update` sont utilisés comme titres des entrées du flux RSS, et les entrées pointent vers leurs ancres de titre dans votre documentation.

```xml Exemple de flux RSS
<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0">
  <channel>
    <title><![CDATA[Mises à jour produit]]></title>
    <description><![CDATA[Nouveautés et améliorations]]></description>
    <link>https://mintlify.com/docs</link>
    <generator>RSS pour Node</generator>
    <lastBuildDate>Mon, 21 Jul 2025 21:21:47 GMT</lastBuildDate>
    <atom:link href="https://mintlify.com/docs/changelog/rss.xml" rel="self" type="application/rss+xml"/>
    <copyright><![CDATA[Mintlify]]></copyright>
    <docs>https://mintlify.com/docs</docs>
    <item>
      <title><![CDATA[Juin 2025]]></title>
      <link>https://mintlify.com/docs/changelog#june-2025</link>
      <guid isPermaLink="true">https://mintlify.com/docs/changelog#june-2025</guid>
      <pubDate>Mon, 23 Jun 2025 16:54:22 GMT</pubDate>
    </item>
  </channel>
</rss>
```

Les flux RSS peuvent s’intégrer à Slack, à l’e-mail ou à d’autres outils d’abonnement pour avertir les utilisateurs des modifications du produit. Voici quelques options :

* [Slack](https://slack.com/help/articles/218688467-Add-RSS-feeds-to-Slack)
* [E-mail](https://zapier.com/apps/email/integrations/rss/1441/send-new-rss-feed-entries-via-email) via Zapier
* Des bots Discord comme [Readybot](https://readybot.io) ou [RSS Feeds to Discord Bot](https://rss.app/en/bots/rssfeeds-discord-bot)

Pour rendre le flux RSS facile à découvrir, vous pouvez afficher en haut de la page un bouton avec l’icône RSS pointant vers le flux. Ajoutez `rss: true` au front matter de la page :

```mdx
---
rss: true
---
```

<Frame>
  <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/K9uomxeMDdJnUp_m/images/changelog-rss-button-light.png?fit=max&auto=format&n=K9uomxeMDdJnUp_m&q=85&s=c9c022f33f707e13d9513fc2355240b7" alt="Page du journal des modifications en mode clair avec le bouton du flux RSS activé." className="block dark:hidden" width="1486" height="388" data-path="images/changelog-rss-button-light.png" />

  <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/K9uomxeMDdJnUp_m/images/changelog-rss-button-dark.png?fit=max&auto=format&n=K9uomxeMDdJnUp_m&q=85&s=f2bad6860a9f217d3b0d019546f8f73d" alt="Page du journal des modifications en mode sombre avec le bouton du flux RSS activé." className="hidden dark:block" width="1486" height="388" data-path="images/changelog-rss-button-dark.png" />
</Frame>