> ## 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).

# Dokumentversionierung

# 📝 **Dokumentversionierung in Brainframe**
> **„Verfolgen Sie jede Änderung, bewahren Sie den vollständigen Verlauf."**
> *Vom Entwurf bis zur genehmigten Version — Brainframe erfasst alles.*
Alle neu erstellten Dokumente starten im **Entwurfsmodus**. Bei jedem Speichern zeichnet Brainframe einen **zeitgestempelten Verlaufseintrag** auf.
---
## 1️⃣ Eine Version zuweisen
Einen Entwurf in ein versioniertes Dokument umwandeln:
![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-07-07-at-16430_yj0vbi.png =983xauto)
1. Öffnen Sie das Dokument in der **Dokumentansicht**.
2. Klicken Sie in der oberen Leiste auf **Version zuweisen**.
3. Geben Sie die neue Versionsnummer im Format **x.y.z** ein (z. B. `1.2.0`) und speichern Sie.
---
## 2️⃣ Versionierungsregeln (SemVer)
Brainframe verwendet [Semantic Versioning](https://semver.org/):
* **x – MAJOR (Hauptversion)**: erste finalisierte Veröffentlichungen oder vollständige Überarbeitungen.
* **y – MINOR (Nebenversion)**: abwärtskompatible Aktualisierungen (hinzugefügte Erläuterungen, kleine Funktionen).
* **z – PATCH**: kleine Korrekturen (Tippfehler, Links, Formatierung).
![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-07-07-at-16434_20y0ug.png =328xauto)
| 📌 Sie können auch eigene Kriterien für die Erhöhung der Versionsnummer festlegen.
---
## 3️⃣ Als überprüft markieren (ohne Inhaltsänderung)
Eine Überprüfung nachverfolgen, ohne eine neue Version zu erstellen:
![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-07-07-at-16441_18jr6ly.png =842xauto)
1. Öffnen Sie den Tab **Aktivitäten**.
2. Aktivieren Sie **Diese Dokumentversion als überprüft markieren**.
3. Speichern Sie.
📌 *Dies aktualisiert das Überprüfungs-/Alterungsdatum, ohne die Version zu ändern.*
---
## 4️⃣ Freigaben nach der Versionszuweisung
Wenn für den [Dokumenttyp](https://docs.brainframe.com/en/article/document-types-templates-lssmkc/) ein **Freigabe-Workflow** konfiguriert ist:
![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-07-07-at-16452_1ddoi7.png =1112xauto)
* Nach der Zuweisung einer Version erscheinen die Workflow-Stufen (z. B. *Überprüfung*, *Genehmigen/Ablehnen*).
* Verwenden Sie **Genehmigen** oder **Ablehnen**, um die konfigurierten Stufen zu durchlaufen.
---
## 5️⃣ Revisionen anzeigen und vergleichen
Der **Tab Revisionen** bietet Ihnen einen vollständigen Prüfpfad:
![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/5_ertppu.png =891xauto)
1. Sehen Sie den **vollständigen Versionsverlauf** ein (wer was wann geändert/genehmigt hat).
2. Wählen Sie eine frühere Version aus, um deren Inhalt anzuzeigen. Verwenden Sie **Änderungen anzeigen**, um Unterschiede zwischen Versionen hervorzuheben. *Nur für Dokumente verfügbar, die mit dem **Standardeditor** erstellt wurden.*
---
## 6️⃣ Bewährte Praktiken
* 🔄 **Verwenden Sie Überprüfungsmarkierungen** für periodische Kontrollen, bei denen keine Inhaltsänderung erforderlich ist.
* 🚨 **Seien Sie konsequent bei SemVer**, damit Ihr Team die Update-Arten versteht.
* 📝 **Fügen Sie klare Versionshinweise hinzu**, um zu dokumentieren, warum Änderungen vorgenommen wurden.
* 👀 **Vergleichen Sie Revisionen regelmäßig**, um subtile Änderungen zu verfolgen.
* ✅ **Verknüpfen Sie Freigaben mit Versionen** für einen vollständigen Prüfpfad.
---
## 🎯 Visuelle Checkliste
* [x] Version gemäß SemVer zugewiesen
* [x] Überprüfungsmarkierung verwendet, wenn keine Inhaltsänderung erfolgt ist
* [ ] Freigabe-Workflow abgeschlossen
* [ ] Revisionsverlauf überprüft und verglichen
* [ ] Versionshinweise für die Auditbereitschaft dokumentiert