> For the complete documentation index, see [llms.txt](https://docs.controlbee.nl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.controlbee.nl/versiebeheer-en-publiceren.md).
# Versiebeheer en publiceren
Concept, beoordeling, publicatie en versietabel bij tekstvelden met versiebeheer
Verschillende tekstvelden in ControlBee zijn voorzien van versiebeheer: de contextbeschrijving, het beleid en de procesbeschrijving. De werking is overal hetzelfde en wordt hier één keer beschreven.
## Werken in concept
Zodra je een bewerking uitvoert, komt er een blauwe balk om het tekstveld te staan om aan te geven dat je wijzigingen in concept staan. De blauwe balk geeft je de mogelijkheid om te schakelen tussen verschillende versies:
* **Concept** — de conceptversie waarmee je aan het werk bent
* **Huidige versie** — het laatst gepubliceerde exemplaar voordat je aan het concept begon
* **Wijzigingen** — de wijzigingen in je conceptversie ten opzichte van de vorige versie, met toevoegingen in groen en verwijderingen in rood
{% hint style="warning" %}
Zolang de blauwe balk in beeld staat, zijn je wijzigingen nog niet verwerkt in een versie. Ze zijn dus ook nog niet zichtbaar in de versietabel en kunnen niet worden geëxporteerd.
{% endhint %}
## Een publicatie starten
Als je klaar bent om het concept te publiceren zodat het ook geëxporteerd kan worden, klik je op de gele knop 'Start publicatie'. Hierna krijg je een formulier met de volgende opties:
* **Beschrijving** — geef hier een korte beschrijving van je wijziging
* **Versie** — hier maken we onderscheid tussen twee soorten versie-updates:
* **Major versie / functioneel** — een wijziging met functionele impact; de publicatie vereist goedkeuring van één of meer mensen, doorgaans de eigenaar
* **Minor versie / niet-functioneel** — een kleine wijziging zonder functionele impact op de organisatie; de publicatie vereist geen goedkeuring
* **Beoordelaars** (alleen bij een major versie) — bij documenten met een eigenaar staat de eigenaar hier standaard al ingesteld. Je kunt ook handmatig gebruikers toevoegen die goedkeuring geven.
* **Goedkeuring vereist door** (alleen bij meerdere beoordelaars) — hier geef je aan of goedkeuring van één of van meerdere personen nodig is.
Zodra er op 'Vraag om beoordeling' wordt geklikt, wordt de beoordeling gestart en krijgen de ingestelde beoordelaars een e-mail over het goedkeuringsverzoek.
## Beoordeling beheren
Zolang een beoordeling openstaat, zijn er de volgende mogelijkheden:
* **Bekijk status → Stuur herinnering** — beschikbaar voor de gebruiker die de beoordeling heeft gestart; stuurt een herinneringsmail naar de beoordelaars
* **Bekijk status → Beoordeel namens** — alleen beschikbaar voor bedrijfsbeheerders en omgevingsbeheerders; hiermee wordt de beoordeling 'namens' de beoordelaar afgerond
* **Beoordeel** — alleen beschikbaar voor de gebruikers die zijn ingesteld als beoordelaar. Het concept kan worden goedgekeurd of afgekeurd met een uitleg.
## Publicatie
Zodra alle beoordelaars het document hebben goedgekeurd, verschijnt er een groene balk en kan het document met de gele knop worden gepubliceerd. De versie wordt bijgeschreven in de versietabel van het document. Het document kan op drie manieren worden gepubliceerd:
* als MS Word-document
* als PDF
* in Markdown via onze API
Na het publiceren verdwijnt de gekleurde balk en begint het proces opnieuw bij de eerstvolgende wijziging.
## Versietabel
De versiegeschiedenis wordt bij functies met versiebeheer automatisch bijgewerkt met de gepubliceerde versies. Het kan echter nodig zijn om de versietabel handmatig te bewerken, bijvoorbeeld omdat er een fout in een publicatie is geslopen of omdat er bestaande documenten in ControlBee worden opgevoerd. Door op de knop 'revisies' te klikken opent de versiegeschiedenis. In dit overzicht kunnen versies handmatig worden toegevoegd en kunnen bestaande versies worden bewerkt en verwijderd.
{% hint style="warning" %}
Er moet altijd minimaal één versie blijven bestaan. Het is dus niet mogelijk om de versiegeschiedenis volledig leeg te maken.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.controlbee.nl/versiebeheer-en-publiceren.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
