versiegeschiedenis

Versiegeschiedenis is de verzameling van alle wijzigingen die in de loop der tijd zijn aangebracht aan een product, zoals software, een document of een dataset, met per versie gegevens over wat is gewijzigd en waarom. Deze geschiedenis maakt het mogelijk om veranderingen te volgen, te begrijpen wat er is gebeurd en waar nodig terug te draaien.

In software en digitale documenten wordt de geschiedenis doorgaans vastgelegd met een versiebeheersysteem (VCS) zoals Git, Subversion of Mercurial. Voor documenten of wikis bestaat vaak een ingebouwde wijzigings- of revisiegeschiedenis. Een versie omvat meestal een versienummer, datum, de maker en een korte samenvatting van de wijziging, en laat diffs of patches zien ten opzichte van de vorige versie.

Semantische versieering is een veelgebruikt patroon: MAJOR.MINOR.PATCH, waarbij majeure, minor en patch wijzigingen onderscheiden worden. Dit helpt bij het communiceren van de impact van een update aan gebruikers en afhankelijkheden. Het doel van versiegeschiedenis is traceerbaarheid, samenwerking, reproduceerbaarheid en het mogelijk maken van terugdraaien van fouten.

Praktisch worden releases vaak getagd en een changelog bijgehouden waarin belangrijke wijzigingen per versie worden samengevat. Een goede praktijk is duidelijke commit-berichten, regelmatige commits, en het gebruik van takken (branches) zodat stabiliteit en ontwikkeling gescheiden blijven. De geschiedenis is vaak vastgelegd in de repository en biedt zo een audittrail en langdurige beschikbaarheid van historische data.