Changelog
Le composant de changelog affiche un historique filtré depuis data/brand/changelog.yml. Utilisez-le lorsqu’une page explique un système qui évolue dans le temps et que le lectorat gagne à savoir ce qui a changé, ce qui est vérifié ou pourquoi l’état actuel est fiable.
Il sert à documenter l’état du système, pas les modifications courantes d’une page.
Journal des changements
Vérification la plus récente de toutes les entrées : août 17, 2026
- Documentation du composant de changelog de marque et de ses pages candidates recommandées après vérification sur les pages de jetons et de contrôles qualité.
Quand l’utiliser#
- Utilisez-le sur les pages où des décisions récentes changent la façon d’interpréter ou d’utiliser les consignes
- Filtrez par sujet pour que chaque page affiche seulement l’historique pertinent
- Gardez les entrées courtes, datées et factuelles; la justification détaillée appartient à la page pertinente ou à l’ADR
- Réutilisez le composant partagé plutôt que de maintenir des listes de changements manuelles en Markdown
Bons candidats#
- Fondations > Jetons : état de la chaîne de jetons, jalons d’activation de Style Dictionary et préparation des catégories générées
- Implémentation du site > Composants : progression de la standardisation des composants et moment où un motif devient réutilisable
- Implémentation du site > Contrôles qualité : contrôles ajoutés, en attente, dépréciés ou promus comme bloquants
- Gouvernance du site > Dossiers de décision : ADR acceptés et consignes publiques qui en découlent
- Fondations > Accessibilité : règles de base, correctifs d’implémentation et outillage de vérification lorsque cet historique devient utile
Implémentation#
Le shortcode est brand-changelog; il lit les entrées localisées dans le fichier de données du système de marque et les transmet au partiel partagé data-changelog.
{{< brand-changelog topic="tokens" >}}Contrat#
| Élément | Source |
|---|---|
| Données | data/brand/changelog.yml |
| Shortcode | layouts/shortcodes/brand-changelog.html |
| Partiel | layouts/partials/data-changelog.html |
| Modèle de sujet | Chaque entrée déclare un ou plusieurs topics |
| Localisation | Chaque entrée contient message.en et message.fr |
Manifeste d’interface
- Nature
- Composant
- Catégorie
- Données
- Statut
- Implémenté
- Implémentation
- Partial:
layouts/partials/data-changelog.htmlShortcode:layouts/shortcodes/brand-changelog.htmlDonnées:data/brand/changelog.ymli18n:dataChangelogdataChangelogChecked
Accessibilité#
- Le composant utilise les éléments natifs
<details>et<summary>; son état de divulgation et son comportement clavier viennent donc du navigateur - Le résumé et le message de date vérifiée utilisent les clés localisées
dataChangelogetdataChangelogChecked - Chaque date de changement est un élément
<time>sémantique; la liste groupée demeure lisible lorsqu’elle est ouverte
À éviter#
- Ne l’utilisez pas pour chaque mise à jour de page; il doit expliquer une évolution significative du système
- Ne dupliquez pas un ADR dans une entrée de changelog; liez la page où la décision est expliquée
- Ne publiez pas des entrées qui ne sont que des intentions; le travail prévu appartient à une feuille de route, à un ADR ou à une section qui le nomme clairement comme travail futur