sanderke
commented
2 years ago Opgenomen in Digikoppeling Overzicht Actuele Documentatie en Compliance 1.9.1 https://github.com/Logius-standaarden/Digikoppeling-Overzicht-Actuele-Documentatie-en-Compliance/pull/2
Aanleiding
Na publicatie worden er soms kleine verbeterpunten ontdekt, zoals tikfouten, gebroken links of ongelukkige zinsconstructies. Om deze verbeteringen niet op te sparen voor de volgende grote release en toch van een nieuwe versienummer te kunnen voorzien, wordt gebruik gemaakt van een patchnummer. Versienummers hebben de vorm MAJOR.MINOR.PATCH
Indien er vermoeden is dat een dergelijke fout tot een andere interpretatie van de materie heeft kunnen leiden door bijvoorbeeld ambiguïteit te introduceren, zal de correctie alsnog onder Minor geschaard worden.
De huidige manier van registratie van patch releases heeft als nadeel dat elke patch meerdere mutaties oplevert in het compliance document en ook de suggestie wekt dat bij elke patch een nieuwe versie van de digikoppeling standaard wordt uitgebracht;
Wijziging
Daar de wijziging de inhoud niet raakt, zal de geldigheid van de huidige minor versie intact blijven. Het voorstel is om patchnummers niet meer te vermelden in de geldigheidstabellen van het normatieve document “Digikoppeling Overzicht Actuele Documentatie en Compliance”. Het patchnummer wordt vervangen met een asterisk in plaats van weggelaten om de structuur van semantisch versioneren te behouden en daarmee duidelijk te maken dat het niet enkel de .0-patchversie beslaat.
De doorgevoerde patches zullen per document in één overzichtelijke lijst op GitHub bijgehouden worden.
Voorbeeld