> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://docs.brainframe.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Versions de documents

# 📝 **Versioning des documents dans Brainframe**
> **« Suivez chaque modification, conservez l'historique complet. »**
> *Du brouillon à la version approuvée, Brainframe enregistre tout.*
Tous les documents nouvellement créés démarrent en mode **Brouillon**. À chaque enregistrement, Brainframe enregistre une **entrée d'historique horodatée**.
---
## 1️⃣ Attribuer une version
Convertir un brouillon en document versionné :
![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-07-07-at-16430_yj0vbi.png =983xauto)
1. Ouvrez le document dans la **vue du document**.
2. Cliquez sur **Attribuer une version** dans la barre supérieure.
3. Saisissez le nouveau numéro de version au format **x.y.z** (par ex. `1.2.0`) et enregistrez.
---
## 2️⃣ Règles de versioning (SemVer)
Brainframe utilise le [Versioning sémantique](https://semver.org/) :
* **x – MAJEUR** : premières versions finalisées ou réécritures complètes.
* **y – MINEUR** : mises à jour rétrocompatibles (explications ajoutées, petites fonctionnalités).
* **z – CORRECTIF** : petites corrections (fautes de frappe, liens, mise en forme).
![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-07-07-at-16434_20y0ug.png =328xauto)
| 📌 Vous pouvez également définir vos propres critères d'incrémentation.
---
## 3️⃣ Marquer comme révisé (sans changement de contenu)
Suivre une révision sans créer de nouvelle version :
![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-07-07-at-16441_18jr6ly.png =842xauto)
1. Ouvrez l'onglet **Activités**.
2. Activez **Marquer cette version du document comme révisée**.
3. Enregistrez.
📌 *Cela met à jour la date de suivi de révision/ancienneté sans modifier la version.*
---
## 4️⃣ Approbations après attribution de version
Si le [type de document](https://docs.brainframe.com/en/article/document-types-templates-lssmkc/) dispose d'un **workflow d'approbation** configuré :
![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-07-07-at-16452_1ddoi7.png =1112xauto)
* Après l'attribution d'une version, les étapes du workflow (par ex. *Révision*, *Approuver/Rejeter*) apparaissent.
* Utilisez **Approuver** ou **Rejeter** pour progresser à travers les étapes configurées.
---
## 5️⃣ Consulter et comparer les révisions
L'**onglet Révisions** vous offre une piste d'audit complète :
![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/5_ertppu.png =891xauto)
1. Consultez l'**historique complet des versions** (qui a modifié/approuvé quoi et quand).
2. Sélectionnez une version précédente pour en voir le contenu. Utilisez **Afficher les modifications** pour mettre en évidence les différences entre les versions. *Disponible uniquement pour les documents créés avec l'**éditeur standard**.*
---
## 6️⃣ Bonnes pratiques
* 🔄 **Utilisez les marques de révision** pour les vérifications périodiques ne nécessitant aucun changement de contenu.
* 🚨 **Soyez cohérent avec le SemVer** afin que votre équipe comprenne les types de mise à jour.
* 📝 **Ajoutez des notes de version claires** pour documenter les raisons des modifications.
* 👀 **Comparez régulièrement les révisions** pour suivre les changements subtils.
* ✅ **Liez les approbations aux versions** pour une piste d'audit complète.
---
## 🎯 Liste de contrôle visuelle
* [x] Version attribuée selon le SemVer
* [x] Marque de révision utilisée lorsqu'aucun changement de contenu n'a eu lieu
* [ ] Workflow d'approbation terminé
* [ ] Historique des révisions vérifié et comparé
* [ ] Notes de version documentées pour la préparation à l'audit