📝 Documentversiebeheer in Brainframe

"Volg elke wijziging, bewaar de volledige geschiedenis."
Van concept tot goedgekeurde versie, Brainframe registreert alles.

Alle nieuw aangemaakte documenten starten in Concept-modus. Elke keer dat je opslaat, registreert Brainframe een tijdgestempeld historisch item.

1️⃣ Een versie toewijzen

Zet een concept om in een versiebeheerd document:

1. Open het document in de Documentweergave.
2. Klik op Versie toewijzen in de bovenbalk.
3. Voer het nieuwe versienummer in met het x.y.z-formaat (bv. 1.2.0) en sla op.

2️⃣ Versieregels (SemVer)

Brainframe gebruikt Semantische Versiebeheer:

• x – MAJOR: Eerste definitieve releases of volledige herschrijvingen.
• y – MINOR: Achterwaarts-compatibele updates (toegevoegde uitleg, kleine functies).
• z – PATCH: Kleine correcties (typfouten, links, opmaak).

3️⃣ Markeren als Gereviewd (zonder inhoudswijziging)

Volg een review zonder een nieuwe versie aan te maken:

1. Open het tabblad Activiteiten.
2. Schakel Markeer deze documentversie als gereviewd in.
3. Sla op.

📌 Dit werkt de review-/leeftijdsdatum bij zonder de versie te wijzigen.

4️⃣ Goedkeuringen na versie-toewijzing

Als het documenttype een goedkeuringsworkflow heeft geconfigureerd:

• Na het toewijzen van een versie verschijnen de workflowstappen (bv. Review, Goedkeuren/Afwijzen).
• Gebruik Goedkeuren of Afwijzen om door de ingestelde stappen te gaan.

5️⃣ Revisies bekijken en vergelijken

Het Revisiestabblad geeft je een volledig auditspoor:

1. Bekijk de volledige versiegeschiedenis (wie wat wanneer wijzigde/goedgekeurde).
2. Selecteer een vorige versie om de inhoud te bekijken. Gebruik Toon wijzigingen om verschillen tussen versies te markeren. Alleen beschikbaar voor documenten gemaakt met de Standaardeditor.

6️⃣ Best Practices

• 🔄 Gebruik reviewmarkeringen voor periodieke controles zonder inhoudswijzigingen.
• 🚨 Wees consistent met SemVer zodat je team begrijpt welk type update is uitgevoerd.
• 📝 Voeg duidelijke versienotities toe om vast te leggen waarom wijzigingen zijn gedaan.
• 👀 Vergelijk revisies regelmatig om subtiele veranderingen op te sporen.
• ✅ Koppel goedkeuringen aan versies voor een volledig auditspoor.

🎯 Checklist

• [x] Versie toegewezen met SemVer
• [x] Reviewmarkering gebruikt waar geen inhoudsverandering plaatsvond
• [ ] Goedkeuringsworkflow afgerond
• [ ] Revisiegeschiedenis gecontroleerd en vergeleken
• [ ] Versienotities gedocumenteerd voor auditvoorbereiding

Bijgewerkt op: 19/09/2025