Le brandbook Gradly est versionné selon un semver simplifié et documenté dans un changelog dédié.
Schéma de versioning
Format : MAJOR.MINOR.PATCH
| Incrément | Déclencheur |
|---|---|
| PATCH (1.0.0 → 1.0.1) | Correction de faute, ajout de précision sans changement de règle, correction visuelle mineure |
| MINOR (1.0.0 → 1.1.0) | Ajout de section, nouvelle règle, extension d’une règle existante |
| MAJOR (1.0.0 → 2.0.0) | Refonte structurelle (changement de palette, nouveau logo, refonte ton de voix, changement de baseline) |
Une version MAJOR est une rupture assumée : les supports produits sous l’ancienne version sont obsolètes et doivent être renouvelés.
Changelog dédié
Le fichier docs/brand/changelog.md tient à jour l’historique complet du brandbook.
Format aligné sur Keep a Changelog :
## [1.0.0] — 2026-04-23 (infrastructure)
### Added
- Infrastructure technique du brandbook : Content Collections MDX...
- Section pilote 1.1 Mission
- ...
### Changed
- ...
### Removed
- ...Chaque release du brandbook est taguée dans git (ex. brand-v1.0.0) pour permettre de revenir à une version antérieure si nécessaire.
Processus de mise à jour
- Modification dans un MDX (ou dans les layouts/composants)
- Build PDF via
npm run brand:pdf - Commit git avec message descriptif (
feat(brand):,fix(brand):,docs(brand):) - Mise à jour du changelog
docs/brand/changelog.mdsi modification notable - Push sur la branche par défaut — déclenche le déploiement Vercel automatique
Pour une version majeure (ex. v2.0.0) :
- Branche dédiée
feat/brandbook-v2 - Modifications batchées
- Build et revue interne
- Merge dans
master - Tag git
brand-v2.0.0 - Annonce via LinkedIn et email partenaires si changement visible
Rapport avec le changelog produit
Deux changelogs distincts :
docs/brand/changelog.md: changements du brandbook (identité, règles, sections)src/pages/changelog.astro: changements du produit Gradly (logiciel desktop : fonctionnalités, bugs, performance)
Ces deux cycles évoluent indépendamment. Un changement produit important (ex. nouvelle fonctionnalité majeure) n’entraîne pas nécessairement un changement de brandbook. Inversement.
Où lire l’historique
- Changelog textuel :
docs/brand/changelog.md - Historique git complet :
git log --oneline -- src/content/brand/ src/layouts/BrandLayout.astro src/pages/brand/ - Tags majeurs :
git tag -l 'brand-v*'
Version actuelle
Brandbook v1.0.0 publié le 2026-04-23. C’est la première version complète. Tout ce qui précède était de l’infrastructure et du placeholder.