Versiebeleid

Wat blijft werken,
en wat nog mag wijzigen.

Een format is pas bruikbaar als je weet waar je op kunt rekenen. Deze pagina zegt precies dat.

Nu: versie 0.9, nog een concept. Zolang het versienummer met een 0 begint, mag het format nog breken. Wie er vandaag mee werkt, moet erop rekenen dat een veld kan verdwijnen of anders gaan heten. Statements blijven leesbaar, maar automatische koppelingen kunnen omvallen.
De belofte vanaf 1.0

Erbij mag. Weg niet.

Vanaf versie 1.0 geldt één regel, en die is bindend.

01 / TOEVOEGEN

Nieuwe velden mogen

Een hogere versie kan velden toevoegen. Een bestand van vandaag blijft geldig.

02 / BEHOUDEN

Bestaande velden blijven

Geen veld verdwijnt, wordt hernoemd of krijgt een andere betekenis. Wat 1.0 betekende, betekent 1.7 nog steeds.

03 / NEGEREN

Lezers slaan over wat ze niet kennen

Wie een lezer bouwt, negeert onbekende velden in plaats van te stoppen. Zo blijft één lezer alle latere versies aankunnen.

Waarom dit werkt. Deze regel komt uit standaarden die decennia meegaan, zoals de IPTC-vocabulaires en schema.org. Ze groeien door toevoeging, nooit door vervanging. Dat is saai en het is precies de bedoeling.
Eigen velden

Uitbreiden zonder af te splitsen.

Mist een fonds, distributeur of verzekeraar iets? Dan hoeft er geen eigen variant van het format te komen.

Elk statement heeft een extensions-object. Daar hangt een organisatie eigen velden onder, achter een eigen sleutel in omgekeerde domeinnaam. Die sleutel is van hen; de rest van het bestand blijft van de standaard.

extensions0.9
"extensions": {
  "nl.filmfonds.v1": { "dossiernummer": "2026-114" },
  "com.voorbeeld-distributeur.v2": { "deliverySpec": "…" }
}

Hetzelfde mag per fase. Een lezer die de sleutel niet kent, slaat hem over.

Controleren

Elk bestand is machinaal te valideren.

Elke versie heeft een gepubliceerd JSON-schema op een vast adres. Elk statement verwijst er zelf naar, dus een ontvanger kan altijd nagaan of een bestand klopt, ook over tien jaar en ook als deze site er niet meer is.

VersieSchema
Naar 1.0

Pas bevriezen als het getest is.

Versie 1.0 komt er niet op een datum, maar op een voorwaarde: als een aantal echte producties het formulier volledig heeft doorlopen en duidelijk is welke vragen in de praktijk niet werken. Tot die tijd is elke wijziging gratis. Daarna kost hij tien jaar.

0.7Eerste opzet

Twaalf fases, vier antwoorden, IPTC-koppeling.

0.8Animatie en mediasoorten

Dertiende fase erbij. Dekking per fase passend gemaakt in plaats van overal beeld en geluid.

0.9Uitbreidbaar

Eigen blok voor AI-materiaal, AI-agent als losse optie, extensions en een gepubliceerd schema.

Vragen over een wijziging?

Zeg het voordat 1.0 er is.

Terug naar het format