- Er zijn momenteel geen algemene standaarden die definiëren hoe het beheer van versies moet worden geïmplementeerd.
- Een duidelijk versiebeleid is cruciaal voor Koppeltaal.
- Aanpassingen en/of wijzigingen op configuratie items (CI) kunnen door belanghebbende worden ingediend bij Koppeltaal.
- Aanpassingen en/of wijzigingen op configuratie items (zoals interfaces, resources of functies) worden verdeeld in een Minor- of Major wijziging. (zie Semantic Versioning 2.0.0)
- Een Major wijziging verstoort het proces of functionaliteit waarbij cliënten functionele en technische aanpassingen MOETEN uitvoeren om de nieuwe wijziging te ondersteunen.
- Een Minor wijziging verstoort NIET het huidige proces of functionaliteit.
- Omdat interacties de basis vormen voor alle functionaliteit van Koppeltaal, mogen ze niet onaangekondigd wijzigen binnen één versie van Koppeltaal.
- Fouten mogen in deze schema's wel conform een fout-procedure worden verbeterd. Hiervoor zullen tussentijdse "builds" opgeleverd worden, indien nodig op de laatste en voorlaatste Koppeltaal versie.
- Tussentijdse "builds" kunnen ook worden gebruikt om kleinere, functionele wijzigingen te realiseren, in dat geval echter uitsluitend op de meest recente Koppeltaal-versie. Een tussentijdse "build" bevat alleen kleinere aanpassingen die geen gevolgen zullen hebben voor bestaande Koppeltaal-implementaties op basis van de laatste en/of de voorlaatste (Major) Koppeltaal-release.
- Een Koppeltaal versie nummering is opgebouwd uit <Major nummer>.<Minor nummer>.<Build nummer>, zodat naar elke unieke configuratie item verwezen kan worden
- Koppeltaal interface specificaties (koppelvlakken) worden vastgelegd met de OpenAPI Specification (OAS)
- Koppeltaal profielen zijn gebaseerd op v4.0.1: R4
- Koppeltaal profielen worden geregistreerd bij Simplifier.net/Koppeltaalv2.0
- Koppeltaal Canonical Base URL is http://koppeltaal.nl/
- Het project FHIR API endpoint van Koppeltaal is beschikbaar bij: https://fhir.simplifier.net/Koppeltaalv2.0
- Koppeltaal publiceert zowel Major versies/releases als eventuele tussentijds builds van de betreffende Koppeltaal-voorzieningen en toepassingen, inclusief specificaties/documentatie, op de website van Koppeltaal
- Leveranciers en gebruikers wordt geadviseerd de meeste recente (Major) versie zo spoedig mogelijk in software te implementeren respectievelijk deze voor te schrijven.
- Gebruikers of leveranciers die extra elementen, buiten de standaard, aan Koppeltaal willen toevoegen kunnen hiertoe wijzigingsverzoek indienen bij Koppeltaal. .
...