📝 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:

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:

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

3️⃣ Als überprüft markieren (ohne Inhaltsänderung)

Eine Überprüfung nachverfolgen, ohne eine neue Version zu erstellen:

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 ein Freigabe-Workflow konfiguriert ist:

• 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:

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

• Version gemäß SemVer zugewiesen
• Überprüfungsmarkierung verwendet, wenn keine Inhaltsänderung erfolgt ist
• Freigabe-Workflow abgeschlossen
• Revisionsverlauf überprüft und verglichen
• Versionshinweise für die Auditbereitschaft dokumentiert

Aktualisiert am: 14/07/2026