Versienummers

Versienummers zijn identificatoren die een specifieke toestand van een product aanduiden, meestal software, maar ook documentatie en hardware. Ze maken wijziging, compatibiliteit en voortgang traceerbaar en helpen gebruikers en ontwikkelaars bij beslissingen zoals upgrades of migraties.

Een veelgebruikte vorm is drie getallen: major.minor.patch (bijv. 3.4.1). Het eerste cijfer (major) wijst op grootschalige, mogelijk compatibiliteitsbrekende wijzigingen; minor voegt functies toe zonder brekende veranderingen; patch bevat bugfixes en kleine verbeteringen.

Semantische versieering (SemVer) specificeert regels voor deze niveaus en voegt pre-release- en build-etiketten toe. Bij SemVer 2.0 leidt een wijziging van major vaak tot brekende wijzigingen, een nieuwe minor tot toevoegingen die achterwaarts compatibel blijven, en een patch tot bugfixes. Pre-release-versies zoals 1.2.0-alpha of 1.2.0-rc.1 geven aan dat de versie nog niet de definitieve status heeft; build-metadata zoals [phone] kan extra informatie leveren zonder de compatibiliteit te beïnvloeden.

Andere systemen bestaan, zoals kalendergebaseerde versies (bijv. 2024.5 of 2024.12) of eenvoudige oplopende reeksen (1, 2, 3). In sommige gevallen worden versie- en API-compatibiliteitsvereisten apart vastgelegd, bijvoorbeeld door een changelog of een compatibiliteitsmatrix.

Best practices omvatten consistente toepassing van versieerregels, het opnemen van duidelijke release-notes, het communiceren van brekende veranderingen bij major-versies en het streven naar achterwaarts compatibiliteit waar mogelijk.