Het wijzigingsprotocol schrijft een vast stramien voor het wijzigen van de het Raamwerk van geo-standaarden voor. Het protocol benoemt de fasen en de op te leveren resultaten. Belangrijk zijn de randvoorwaarden en uitgangspunten. De gebruikers, deskundigen (experts) en andere stakeholders van het Raamwerk van geo-standaarden worden bij het wijzigen van het Raamwerk van geo-standaarden nauw betrokken.
Het wijzigingsprotocol voor het Raamwerk van geo-standaarden geeft:
- Inzicht in het behandel- en besluitproces dat ten grondslag ligt aan het versiebeheer;
- Inzicht in de wijzigingsverzoeken;
- Inzicht in een voorgestelde wijziging van het Raamwerk;
- Stabiliteit aan het Raamwerk;
- Continuïteit aan het Raamwerk;
- Een eenduidige aanpak.
Een release van een standaard is een nieuwe uitgave van het Raamwerk. De wijzigingen binnen een release wordt gedocumenteerd en vastgelegd in Bijlage A van het informatiemodel. De gebruiker kan zo nagaan op welke plaatsen de betreffen het Raamwerk gewijzigd is. De nieuwe release kenmerkt zich ten opzichte van de oude versie door een hoger versienummer. Bij de release is ieder product van het Raamwerk voorzien van een nieuw versienummer conform Semantic Versioning (SemVer). Binnen SemVer heeft elk product zijn eigen versienummer conform de X.Y.Z schrijfwijze, bijvoorbeeld versie 2.1.0 (=X.Y.Z):
- X-wijziging. Indien het Raamwerk van geo-standaarden een majeure update krijgt met relatief veel nieuwe en ingrijpende wijzigingen dan wordt het Raamwerk als geheel aangeduid met een X wijziging. Frequentie: op voorstel van Geonovum en in overleg met het Regie-overleg geo-standaarden.
- Y-wijziging. Indien het Raamwerk van geo-standaarden een beperkte update krijgt met een relatief klien aantal en minder ingrijpende wijzigingen dan wordt het Raamwerk als geheel aangeduid met een Y wijziging. Frequentie: op voorstel van Geonovum en in overleg met het Regie-overleg geo-standaarden.
- Z-wijziging. Dit zijn bugs/fouten of aanvullingen in een toelichting, die geen impact hebben op de geo-standaarden en hun versie aanduiding. Frequentie: zo spoedig mogelijk na constatering door Geonovum.
Na het uitbrengen van een nieuwe versie van een standaard is deze nieuwe versie beschikbaar en vindbaar via de Geonovum website, onderdeel samenhang geo-standaarden op de pagina standaardisatie.
De SemVer-methodiek schrijft backwards compatibility voor op het Y-niveau. Een nieuwe versie dwingt daarmee geen directe overstap af bij de gebruikers, tenzij anders (bijvoorbeeld wettelijk) bepaald. Na het uitbrengen van de nieuwe versie van het Raamwerk wordt de ontwikkeling van de oude versie stop gezet. Voor het onderhoud en de ondersteuning van een oude versie van een standaard gelden de volgende uitgangspunten:
- Aan een oude versie worden geen nieuwe features toegevoegd, geen aanpassingen gedaan na het uitbrengen van een nieuwe versie. Verzoeken om aanpassing en wijziging voor nieuwe functionaliteit worden niet meer voor het oude Raamwerk in behandeling genomen. Correcties (Z-wijzigingen) worden wel uitgevoerd op de vorige versies zolang deze nog ondersteund worden.
- Bij oplevering van een nieuwe versie wordt de voorgaande versie nog een van te voren vastgestelde periode ondersteund. De duur van de overgangsperiode wordt mede bepaald door de omvang van de wijzigingen (X, Y en Z wijzigingen op de vorige versies), de staat van ontwikkeling van het Raamwerk, en of het Raamwerk in voorlopig dan wel permanent beheer is.
In paragraaf releasebeleid zijn de X, Y en Z wijzigingen uitgelegd. Wijzigingen kennen drie procesvarianten: eén voor X wijzigingen, één voor Y wijzigingen en één voor Z wijzigingen. De start van het proces is voor alle varianten hetzelfde. Op de website wordt een wijzigingsverzoek ingediend bij de Helpdesk geo-standaarden. De impact van deze wijziging wordt door de Werkgroep Raamwerk van geo-standaarden beoordeeld. Deze eerste impactanalyse beoordeelt tot welke SemVer categorie de wijziging hoort en wat de effecten van de wijziging zijn. Naast de impactanalyse wordt het wijzigingsverzoek . Proces voor X en Y wijzigingen X en Y wijzigingen vergen volledige afstemming en het doorlopen van alle in paragraaf 5.1 beschreven fasen: Inhoud, Toetsing, Besluitvorming en Implementatie. Voor de inhoudelijke fase wordt een werkgroep gestart met daarin deskundigen (experts). Het resultaat van de werkgroep is een wijzigingsvoorstel dat in het standaardenoverleg van Geonovum en in het overleg van de Regiegroep geo-standaarden met externe stakeholders wordt besproken. Y en X wijzigingen worden altijd voorgelegd aan de Programmaraad Geonovum, die stelt een nieuwe versie van de Raamwerk van geo-standaarden vast. Proces voor Z wijzigingen In overleg met de Werkgroep Raamwerk van geo-standaarden worden Z wijzigingen in de volgende release opgenomen. De inhoudelijke fase wordt door het beheer van het Raamwerk uitgevoerd. Besluitvorming vindt plaats in afstemming met de Werkgroep. Implementatie vindt plaats door het publiceren van de wijziging op de Geonovum website.
De volgende betrokkenen spelen een rol in het wijzigingsproces van het Raamwerk van geo-standaarden:
Rol |
Stakeholder |
---|---|
Opdrachtgever (eigenaar) van het Raamwerk van geo-standaarden |
Programmaraad van Geonovum bestaande uit vertegenwoordigers van Kadaster, Ministerie van EZK en Ministerie van LNV, Provincie Gelderland namens de provincies en het Interprovinciaal Overleg (IPO), Ministerie van Defensie - Dienst der Hydrografie, Rijkswaterstaat, Ministerie van BZK, Geologische Dienst Nederland TNO, Vereniging van Nederlandse Gemeenten. |
Regie-overleg geo-standaarden |
Het Regie-overleg heeft een diverse samenstelling van beheerders, gebruikersvertegenwoordigers en liaison met relevante standaarden organisaties. Het adviseert de Programmaraad, werkt in werkgroepen, agendeert binnen domeinstandaarden en informeert het programma Zicht op Nederland Datafundament. |
Werkgroep Raamwerk van geo-standaarden |
Adviseurs en experts geo-standaarden Geonovum |
Helpdesk geo-standaarden |
Adviseurs en experts geo-standaarden Geonovum |