Versnummering

Versnummering is een systeem voor het identificeren en ordenen van verschillende versies van een product, zoals software, documentatie of datasets. Het dient om aan te geven welke releasedata en welke wijzigingen zijn doorgevoerd, en om compatibiliteit met andere onderdelen te communiceren.

Een veelgebruikte indeling bestaat uit cijfers die meestal met puntjes gescheiden zijn, bijvoorbeeld MAJOR.MINOR.PATCH. Soms wordt ook een voorlooptekst gebruikt (v1.2.3) of extra labels met bouw- of prerelease-informatie.

Semantic Versioning (SemVer) is een wijdverspreide standaard. Bij SemVer vervangt men de rollen: major wijzigt bij onbreekbare API-wijzigingen; minor bij toevoegingen die backward-compatibel zijn; patch bij bugfixes die backward-compatibel zijn. Pre-release versies krijgen suffixes zoals -alpha, -beta, -rc. Bouwmetadata kan na een plus-teken volgen.

Andere systemen bestaan, zoals kalenderversies die jaartal en datum opnemen (YYYY.MM.DD), of simpele major-minor of build-nummers. Sommige projecten richten zich op semantische compatibiliteit, anderen geven minder nadruk aan API-gebonden veranderingen. Release notes en changelog blijven belangrijk om veranderingen te communiceren.

In de praktijk wordt versnummering vaak gekoppeld aan versiebeheer via tags en releases, waardoor gebruikers en afhankelijkheden kunnen kiezen welke versie ze gebruiken. Een duidelijke versie volgorde en consistente update-strategie maken afhankelijkheidsbeheer en reproduceerbaarheid mogelijk.