Versienummers uitleg
Onze software volgt de Semantic Versioning standaard. Dit betekent dat elk versienummer is opgebouwd uit drie getallen: MAJOR.MINOR.PATCH (bijvoorbeeld 2.4.1).
De betekenis van deze getallen helpt je direct te begrijpen wat de impact is van een update.
🔴 MAJOR: Structurele wijzigingen
Dit getal wordt verhoogd bij wijzigingen die de structuur van de invoer of uitvoer fundamenteel veranderen, bijvoorbeeld in het datamodel of de API.
- Kenmerk: De conversie tussen versies is vaak niet meer mogelijk zonder menselijke input (breaking changes).
- Voorbeeld: Het veld 'isolatiewaarde' wordt opgesplitst in twee losse velden: 'λ-waarde' en 'dikte'.
🟠 MINOR: Inhoudelijke wijzigingen
Dit getal wordt verhoogd bij functionele toevoegingen of aanpassingen in de rekenkern. Het datamodel breekt niet, maar het rekenresultaat kan wel (binnen de marge van de testresultaten) enigszins veranderen.
- Kenmerk: Bestanden zijn direct compatibel (automatische conversie), maar een herberekening kan een andere uitkomst geven.
- Voorbeeld: Het toevoegen van een nieuwe, optionele techniek (zoals een nieuw type douche-WTW).
🟢 PATCH: Onderhoud & Bugfixes
Dit getal wordt verhoogd bij wijzigingen die weinig of geen invloed hebben op de rekenresultaten of de publieke interface.
- Kenmerk: Volledig risicoloos voor de gebruiker. De geldigheid van een bestaand energielabel blijft behouden.
- Voorbeeld: Een fix van een UI-bug (bijvoorbeeld een knop die niet goed uitlijnt).
Overzicht
| Type | Wijzigt Datamodel? | Wijzigt Resultaat? | Voorbeeld |
|---|---|---|---|
MAJOR | Ja (via conversie) | Mogelijk | Splitsen van invoervelden |
MINOR | Nee (enkel optioneel) | Mogelijk | Nieuwe, optionele techniek toegevoegd |
PATCH | Nee | Nee | Performance verbetering / UI-fix |