Versioneringsstrategi og princip

Som overordnet princip for versionering af datamodeller og snitflader anvendes semantic versioning (https://semver.org ), hvor der arbejdes med 3 niveauer af versioner:

Major.Minor.Patch

• MAJOR version, når der foretages inkompatible ændringer,

• MINOR version, når der tilføjes funktionalitet/ændringer i en bagudkompatibel måde

• PATCH version, når der laves bagudkompatible fejlrettelser.

Når en datamodel eller snitflade foreligger i en version 1.0.0, følges versioneringsprincippet stringent.

Version 1.0.0 for datamodeller er som udgangspunkt den version af datamodeller, hvor kommentarer fra offentlig kommentering er indarbejdet og er samtidig den første version, der sættes i produktion på Orkestreringskomponenten. Version 1.0.0 af snitflader er den version af snitfladen der implementer version 1.0.0 af den tilhørende datamodel.

Endelige versioner af datamodeller og tilhørende produkter, f.eks. skemaer og mapningsdokumenter følger version for datamodel. Dvs. at hvis datamodel foreligger i en version 2.0.0, vil de øvrige produkter have tilsvarende version. 

Arbejdsversioner af datamodeller og snitflader

For versionering af datamodeller og snitflader, før der foreligger en version 1.0.0, følges versioneringsprincippet kun i tilnærmelsesvis, da disse versioner er arbejdsversioner, der generelt er karakteriseret ved mange ændringer der ofte også er inkompatible. Følgende er gældende for arbejdsversioner: 

• Ved ændringer i arbejdsversioner, løftes versionen alene på Patch-niveau.

• Minor-niveau anvendes til at fastholde stabile arbejdsversioner, fx version der er anvendt som udgangspunkt for UX mockup eller andre aktiviteter i design og udviklingsarbejdet der forudsætter et fast grundlag

• Version 0.8.0 er den version der anvendes om grundlag for brugertest af UX-mockup

• Version 0.9.0 er den version der som udgangspunktsendes i offentlig kommentering

• Snitflader i testmiljøer følger version af datamodel