MinBZK · ravimeijerrig · Jul 4, 2025 · Sep 2, 2025
@@ -0,0 +1,50 @@
+name: Sync Document Versions
+
+on:
+  push:
+    branches: [main]
+    paths: ['docs/voldoen-aan-wetten-en-regels/**/*.md']
+
+permissions:
+  contents: write
+
+jobs:
+  version-sync:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          fetch-depth: 0  # Full history needed for git log
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+          cache: 'pip'
+
+      - name: Configure git
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+
+      - name: Sync document versions
+        run: |
+          cd docs/voldoen-aan-wetten-en-regels
+          python version_helper.py sync --all
+
+      - name: Check for changes
+        id: git-check
+        run: |
+          git diff --quiet docs/voldoen-aan-wetten-en-regels/ || echo "changes=true" >> $GITHUB_OUTPUT
+
+      - name: Commit version updates
+        if: steps.git-check.outputs.changes == 'true'
+        run: |
+          git add docs/voldoen-aan-wetten-en-regels/
+          git commit -m "Auto-update document versions [skip ci]"
+          git push
@@ -2,6 +2,8 @@
 title: AI-verordening in het kort
 summary: Korte uitleg van de Europese AI-verordening voor verantwoorde AI
 hide: navigation
+version: "1.0.0"
+version_date: "2025-07-04"
 ---
 
 

@@ -0,0 +1,89 @@
+# Document Versioning System
+
+Dit document beschrijft het git-gebaseerde versioning systeem voor de juridische content in het Algoritmekader.
+
+## Hoe het werkt
+
+Het systeem gebruikt **git commit hashes** als versienummers in plaats van handmatige semantic versioning. Dit zorgt voor:
+- ✅ Automatische versioning bij elke wijziging
+- ✅ Perfecte traceerbaarheid naar exacte git commit
+- ✅ Geen handmatige versie bumps meer nodig
+- ✅ Werkt met squash, rebase en alle merge strategieën
+
+## Automatische GitHub Action
+
+Bij elke push naar `main` die markdown bestanden in `docs/voldoen-aan-wetten-en-regels/` wijzigt:
+
+1. **GitHub Action triggert** (`.github/workflows/version-sync.yaml`)
+2. **Git configuratie** wordt ingesteld voor commits
+3. **Dependencies** worden geïnstalleerd (`pip install -r requirements.txt`)
+4. **Script draait** (`python version_helper.py sync --all`)
+5. **Wijzigingen gedetecteerd** met git diff
+6. **Automatische commit** wordt gemaakt met `[skip ci]` om loops te voorkomen
+7. **Push naar repository** met `contents: write` permissions
+
+## Handmatige gebruik
+
+```bash
+# Status van alle bestanden bekijken
+python version_helper.py status
+
+# Nieuwe versie toevoegen voor specifiek bestand
+python version_helper.py add hulpmiddelen/AIIA.md
+
+# Alle bestanden syncen met git
+python version_helper.py sync --all
+
+# Force sync (ook als hash gelijk is)
+python version_helper.py sync --all --force
+```
+
+## Bestandsstructuur
+
+### Frontmatter in .md bestanden
+```yaml
+---
+title: AI Impact Assessment (AIIA)
+# ... andere metadata ...
+version: "92559128"
+version_date: "2025-07-04"
+---
+```
+
+### Registry in versions.yml
+```yaml
+files:
+  ./hulpmiddelen/AIIA.md:
+    current_version: '92559128'
+    version_type: git
+    created_date: '2025-07-04'
+    versions:
+    - version: '92559128'
+      date: '2025-07-04'
+      changes: 'Initial set-up versioning legal content AK'
+      type: git
+```
+
+## Versie Formaat
+
+- **Git hash**: 8-karakter short hash (bijv. `92559128`)
+- **Datum**: YYYY-MM-DD formaat van git commit
+- **Changes**: Originele git commit boodschap
+- **Type**: `git` (om te onderscheiden van legacy semantic versioning)
+
+## GitHub Action Vereisten
+
+Voor een succesvolle werking van de automatische versioning:
+
+- **Repository permissions**: `contents: write` ingesteld in workflow
+- **Dependencies**: `requirements.txt` aanwezig in repository root
+- **Git configuratie**: Automatisch ingesteld met github-actions[bot] credentials
+- **Skip CI**: `[skip ci]` voorkomt oneindige loops bij auto-commits
+
+## Migration Status
+
+Het systeem is volledig gemigreerd naar git hash versioning:
+- **Alleen**: Git hash versioning (`92559128`) - gebruikt voor alle content
+- **Legacy**: Semantic versioning volledig verwijderd uit systeem
+
+Alle bestanden gebruiken nu uitsluitend git-gebaseerde versioning voor consistency en traceerbaarheid.
@@ -43,6 +43,8 @@ rollen:
 - projectleider
 - beleid-en-advies
 hide: navigation
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -38,6 +38,8 @@ rollen:
 - projectleider
 - beleid-en-advies
 hide: navigation
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -30,6 +30,8 @@ rollen:
 - ontwikkelaar
 - projectleider
 hide: navigation
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -20,6 +20,8 @@ rollen:
 - ontwikkelaar
 - projectleider
 hide: navigation
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -25,6 +25,8 @@ rollen:
 - jurist
 - projectleider
 hide: navigation
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -22,6 +22,8 @@ rollen:
 - jurist
 - beleid-en-advies
 hide: navigation
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -15,6 +15,8 @@ rollen:
 - projectleider
 - ontwikkelaar
 hide: navigation
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -20,6 +20,8 @@ maatregel:
 - 5-ver-03-biasanalyse
 - 6-imp-02-aselecte-steekproeven
 hide: navigation
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -32,6 +32,8 @@ hide:
 - navigation
 - toc
 
+version: "e33a2081"
+version_date: "2025-08-26"
 ---
 
 <!-- Let op! onderstaande regel met 'tags' niet weghalen! Deze maakt automatisch de knopjes op basis van de metadata  -->

@@ -23,6 +23,8 @@ maatregel:
 hide:
 - navigation
 - toc
+version: "e33a2081"
+version_date: "2025-08-26"
 ---
 
 <!-- tags -->

@@ -2,6 +2,8 @@
 title: Hulpmiddelen
 summary: Overzicht van de aanbevolen hulpmiddelen voor overheden die algoritmes of AI ontwikkelen of gebruiken. De hulpmiddelen helpen om te voldoen aan de vereisten.
 hide: navigation
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 # Hulpmiddelen

@@ -20,6 +20,8 @@ maatregel:
 - 2-owp-25-kennisoverdracht-en-ondersteuning-aanbieder
 - 2-owp-02-data-beschikbaarheid
 hide: navigation
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -15,6 +15,8 @@ rollen:
 - projectleider
 - beleid-en-advies
 hide: navigation
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -46,6 +46,8 @@ rollen:
 - jurist
 - beleid-en-advies
 hide: navigation
+version: "e33a2081"
+version_date: "2025-08-26"
 ---
 
 <!-- tags -->

@@ -23,6 +23,8 @@ rollen:
 - beleid-en-advies
 - jurist
 hide: navigation
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -19,6 +19,8 @@ rollen:
 - beleid-en-advies
 - jurist
 hide: navigation
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -4,6 +4,8 @@ summary: In het Algoritmekader staan alle regels, tips en hulpmiddelen voor vera
 hide:
   - toc
   - navigation
+version: "e33a2081"
+version_date: "2025-08-26"
 ---
 # Voldoen aan wetten en regels
 

@@ -21,6 +21,8 @@ hide:
 - navigation
 - toc
 
+version: "e33a2081"
+version_date: "2025-08-26"
 ---
 
 <!-- tags -->

@@ -20,6 +20,8 @@ hide:
 - navigation
 - toc
 
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -16,6 +16,8 @@ sources:
 hide:
 - navigation
 - toc
+version: "92559128"
+version_date: "2025-07-04"
 ---
 <!-- tags -->
 

@@ -19,6 +19,8 @@ hide:
 - navigation
 - toc
 
+version: "e33a2081"
+version_date: "2025-08-26"
 ---
 
 <!-- Let op! onderstaande regel met 'tags' niet weghalen! Deze maakt automatisch de knopjes op basis van de metadata  -->

@@ -13,6 +13,8 @@ onderwerp:
 hide:
 - navigation
 - toc
+version: "92559128"
+version_date: "2025-07-04"
 ---
 <!-- tags -->
 

@@ -15,6 +15,8 @@ rollen:
 hide:
 - navigation
 - toc
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -12,6 +12,8 @@ onderwerp:
 hide:
 - navigation
 - toc
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -12,6 +12,8 @@ rollen:
 hide:
 - navigation
 - toc
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -14,6 +14,8 @@ sources:
 hide:
 - navigation
 - toc
+version: "92559128"
+version_date: "2025-07-04"
 ---
 
 <!-- tags -->

@@ -12,6 +12,8 @@ rollen:
 hide:
 - navigation
 - toc
+version: "e33a2081"
+version_date: "2025-08-26"
 ---
 
 <!-- tags -->