Verschillende typen releases, en correcties

Releases voor het afsprakenstelsel worden als volgt aangeduid:

1. Major releases: releases met grotere (functionele) wijzigingen. Deze releases worden opgenomen in de releaseplanning;

2. Minor releases: releases met twee soorten correctief onderhoud:

   1. Wijzigingen die nodig zijn om een onmiddellijke dreiging voor de continuïteit van of het vertrouwen in het MedMij Afsprakenstelsel/-netwerk af te wenden;

   2. Verbeteringen waarvan de baten van spoedig doorvoeren significant groter zijn dan de implementatie-inspanningen, en die op breed draagvlak onder de deelnemers kunnen rekenen.

De aanduiding van releases is opgebouwd uit drie nummers, namelijk x.y.z (bijvoorbeeld 1.3.2). Bij een major release wordt de combinatie x.y opgehoogd. Daarbij zijn twee opties, ofwel y wordt met een verhoogd waarna z op 0 wordt gezet (bijvoorbeeld van 1.3.2 naar 1.4.0), ofwel x wordt met een verhoogd waarna y en z op 0 worden gezet (bijvoorbeeld van 1.3.2 naar 2.0.0). De keuze hiertussen is afhankelijk van aard en omvang van de release. Bij een minor release wordt z met een verhoogd (bijvoorbeeld van 1.3.2 naar 1.3.3).

Major release vinden twee maal per jaar plaats. De inhoud van een major release wordt  samengesteld op basis van uitgewerkte wijzigingsvoorstellen (RFC's). Minor releases zijn niet bij voorbaat gepland; zij worden alleen indien nodig tussen major releases uitgebracht, op een datum die in overleg met Deelnemers wordt vastgesteld.

Daarnaast kunnen correcties op het MedMij Afsprakenstelsel worden aangebracht zonder dat deze leiden tot een nieuwe release. Deze doen bijvoorbeeld acute reparaties, verwijderen inconsistenties of passen voorbeeldberichten aan. Een correctie tast de juridische en technische strekking van het MedMij Afsprakenstelsel niet aan; waar dit wel het geval zou zijn, vereist de wijziging een nieuwe release. Correcties worden op een aparte pagina in het MedMij Afsprakenstelsel aangegeven. 

Stelselovergang van Optioneel naar Verplicht en de introductie van de nieuwe Optionele stelselversie

Major

Niet backward compatibel publicatie (Core Stelsel en of gegevensdiensten inclusief R&A)

Major

Compatibel publicatie (Extensies, Core en Gegevensdiensten inclusief R&A blijft compatibel)

Minor

Correcties (tussentijdse) publicatie met niet functionele aanpassingen en tekstuele correcties. 

Patch

Software-industrie standaard manier van versienummering Major, Minor, Patch.

Met twee gepubliceerde versies gaan de gebruikte versienummers overlappen bij een Major update

MMVerplicht 1.5.1

MMOptioneeel 1.6.0

Major update => MMVerplicht 2.0.0 en MMOptioneel 2.0.0. <= Geen unieke identificatie meer.

Dit is het huidige format wat we gebruiken.

In het huidige format gebruiken we de Minor als 'release versie ID' => release MMOptioneel okt 2022 wordt dan 1.7.0.
We verliezen hierbij de optie om Minor en Patch publicaties te verwerken (Minor zou dan in de Patch ID geplaatst moeten worden.) geen extra digit voor Patch over.

We hanteren nu voor de R&A de volledige ID string => 1.5.0 (De MMVerplicht versie van het stelsel is nu 1.5.1.
De discrepantie tussen de laatste digit heeft veel vragen/onduidelijkheid opgeleverd)

Bij elke aanpassing van SemVer nummer moet de R&A SW aangepast worden om de nieuwe versie te herkennen.

Bij elke aanpassing van SemVer nummer moeten alle R&A URI's aangepast worden.

Gebruik van (Epoch) timestamp is een simpel nummering format. 

Met twee gepubliceerde versies gaan de gebruikte versienummers overlappen bij een publicatie update op beide gepubliceerde versies

MMVerplicht 1.5.1

MMOptioneeel 1.6.0

Update => MMVerplicht 2022-08-23 en MMOptioneel 2022-08-23 <= Geen unieke identificatie meer.

(Epoch) timestamp geeft geen indicatie wat de impact is van de change (Major, Minor, Patch)

Bij elke aanpassing van het (Epoch) timestamp  moet de R&A SW aangepast worden om de nieuwe versie te herkennen.

Bij elke aanpassing van het (Epoch) timestamp moeten alle R&A URI's aangepast worden.

Gebruik van Sequentieel nummer is een simpel nummering format. 

Met twee gepubliceerde versies gaan de gebruikte versienummers overlappen bij een publicatie update op beide gepubliceerde versies

MMVerplicht 1.5.1

MMOptioneeel 1.6.0

Update => MMVerplicht 2 en MMOptioneel 2 <= Geen unieke identificatie meer.

Update MMOptioneel 2 => 3 =>4 => 5 

Update MMVerplicht 2 => 3 => het nummer 3 is reeds uitgegeven aan MMVerplicht, geen unieke identificatie meer

Sequentieel nummer geeft geen indicatie wat de impact is van de change (Major, Minor, Patch)

Bij elke aanpassing van het Sequentieel nummer moet de R&A SW aangepast worden om de nieuwe versie te herkennen.

Bij elke aanpassing van het Sequentieel nummer moeten alle R&A URI's aangepast worden.

Combinatie maakt unieke identificatie van 2 gepubliceerde versies mogelijk.

Door de toevoeging van de Epoch Date is er altijd een uniek startpunt voor een release versie. 
Gedurende de life cycle van deze release blijft dit deel constant (en daarmee ook uniek) 

Complexere Versie-string format

Maakt onderscheid tussen Versie release (Major) en Major Patch mogelijk.

Bij Major publicatie is nog steeds in de R&A de aanpassing van alle URI's noodzakelijk!

Meer impact analyse nodig of een change Major / Minor is

Maakt het mogelijk om voor de R&A alleen de release-Major identificatie te gebruiken. 

Bij elke aanpassing van Hybride (basis) nummer moet de R&A SW aangepast worden om de nieuwe versie te herkennen

Bij Minor en Patch publicatie is geen R&A aanpassing van alle URI's noodzakelijk!

Eenmalige aanpassing van Versienummering van alle R&A URI's noodzakelijk.

Ook tekst correcties kunnen (zonder impact op comptabiliteit) kunnen nu in een standaard gecontroleerd change proces gepubliceerd worden, inclusief Patch-versienummer aanpassing (change traceability en verantwoording)

Publicatie-7-1.0.0

Publicatie-7-1

Publicatie-7-1.0.1 (Patch)

Publicatie-7-1

Publicatie-7-1.0.2 (Patch)

Publicatie-7-1

Publicatie-7-1.1.0 (Minor)

Publicatie-7-1

Publicatie-7-2.0.0 (Urgent Major) 

Publicatie-7-2

Publicatie-8-1.0.0 (Opvolgende Major stelsel release) 

Publicatie-8-1