diff --git a/docs/managementmanual/h/1.md b/docs/managementmanual/h/1.md index 39ea5956..9926fbd8 100644 --- a/docs/managementmanual/h/1.md +++ b/docs/managementmanual/h/1.md @@ -4,6 +4,22 @@ Dit document beschrijft de beheerhandleiding van de NLCS. +## Beheerdocument DigiGO + +De basis voor deze beheerhandleiding is het [Beheerdocument DigiGO](https://www.bimloket.nl//documents/Beheerdocument_open_BIM-standaarden_v1_8.pdf). Deze handleiding vorm een concrete uitwerking van het beheerdocument en is bedoeld als aanvulling, niet als vervanging. +* [Beheerorganisatie NLCS](https://www.bimloket.nl/p/434/Organisatie-beheer) + + + +## Releaseprotocol +* [Releaseprotocol NLCS](https://nl-digigo.github.io/NLCS/releaseprotocol) + + +## Afhandeling gebruikerswensen +* [Gebruikerswens indienen](https://github.com/nl-digigo/NLCS/issues) +* [Protocol afhandelen gebruikerswensen](https://github.com/nl-digigo/NLCS/blob/main/instructies/RASCI%20Github%20issues%20NLCS.pdf). + + ## Issues te verwerken in dit document
diff --git a/docs/releaseprotocol/config.js b/docs/releaseprotocol/config.js index 87abe698..93c5e3da 100644 --- a/docs/releaseprotocol/config.js +++ b/docs/releaseprotocol/config.js @@ -1,6 +1,6 @@ var respecConfig = { // => https://github.com/stichting-crow/respec/wiki - specStatus: "DRAFT", + specStatus: "DEF", shortName: "NLCS/releaseprotocol", specType: "beheerdocumentatie", // vrije tekst, kleine letter imprint: "bimloket", @@ -21,19 +21,4 @@ var respecConfig = { github: "https://github.com/nl-digigo/NLCS", license: "cc-by", lint: { "no-unused-dfns": false }, - localBiblio: { - NEN_2660_2_2022: { - title: "NEN 2660-2 Regels voor informatiemodellering van de gebouwde omgeving - Deel 2: Praktische configuratie, extensie en implementatie van NEN 2660-1", - href: "https://www.nen.nl/en/nen-2660-2-2022-nl-291667", - status: "Actueel", - publisher: "NEN", - }, - NEN_2660_1_2022: { - title: "NEN 2660-1 Rules for information modelling of the built environment - Part 1: Conceptual models", - href: "https://www.nen.nl/en/nen-2660-1-2022-nl-291666", - status: "Actueel", - publisher: "NEN", - }, - - }, }; diff --git a/docs/releaseprotocol/h/0-samenvatting.md b/docs/releaseprotocol/h/0-samenvatting.md index 1662b4bd..165e044d 100644 --- a/docs/releaseprotocol/h/0-samenvatting.md +++ b/docs/releaseprotocol/h/0-samenvatting.md @@ -1 +1,11 @@ -Dit document beschrijft het releaseprotocol van NLCS, de stappen die worden ondernomen om te komen tot een nieuwe release \ No newline at end of file +Dit document beschrijft het releaseprotocol van NLCS, de stappen die worden ondernomen om te komen tot een nieuwe release. + +Dit protocol is onderdeel van een reeks documenten over het beheer van NLCS: + + +* [Beheerdocument DigiGO](https://www.bimloket.nl//documents/Beheerdocument_open_BIM-standaarden_v1_8.pdf) +* [Beheerorganisatie NLCS](https://www.bimloket.nl/p/434/Organisatie-beheer) +* [Beheerhandleiding NLCS](https://nl-digigo.github.io/NLCS/managementmanual) +* [Releaseprotocol NLCS](https://nl-digigo.github.io/NLCS/releaseprotocol) +* [Gebruikerswens indienen](https://github.com/nl-digigo/NLCS/issues) +* [Protocol afhandelen gebruikerswensen](https://github.com/nl-digigo/NLCS/blob/main/instructies/RASCI%20Github%20issues%20NLCS.pdf). \ No newline at end of file diff --git a/docs/releaseprotocol/h/1.md b/docs/releaseprotocol/h/1.md index 36ac22a1..41cfe7c7 100644 --- a/docs/releaseprotocol/h/1.md +++ b/docs/releaseprotocol/h/1.md @@ -3,18 +3,41 @@ ## Doel documentatie Dit document beschrijft het releaseprotocol van de NLCS. +
+flowchart van het releaseprotocol zoals beschreven in dit document +
Releaseprotocol +
+ ## Releaseprotocol -### Voorbereiding -Voorafgaand aan een release wordt deze in GitHub opgenomen als [Milestone](https://github.com/nl-digigo/NLCS/milestones). De issues die in de release worden afgehandeld, worden gekoppeld aan deze milestone. +## Voorstel + + +#### Gebruikerswensen +Een gebruiker dient voorstellen in voor een (onderdeel van) een release van NLCS, in de vorm van issues op Github. + +#### Rol inhoudelijke werkgroep +Een inhoudelijke werkgroep kan samenwerken aan een voorstel voor het toeoegen of wijzigen van een specifieke groep objecten of een technisch onderdeel van NLCS. + +#### Release volgen in Github +Voorafgaand aan een potentiële release wordt deze in GitHub opgenomen als [Milestone](https://github.com/nl-digigo/NLCS/milestones). De issues die in de release worden afgehandeld, worden gekoppeld aan deze milestone. -### Afhandeling issues -De geselecteerde issues worden één voor één beoordeeld door de expertcommissie. Bij fundamentele beslissingen wordt de keuze voorgelegd aan de beheercommissie. Vervolgens wordt de issue afgehandeld, met de uitwerking klaar in de beheeromgeving voor de release van een concept-publicatie. +### Advies expertcommissie +De geselecteerde issues in een release worden één voor één beoordeeld door de expertcommissie. Als het voorstel past binnen de structuur en werkwijze van NLCS en het betreft slechts een uitbreiding van objecten, kan de expertcommissie direct een positief advies geven. Bij fundamentele beslissingen die de werking van de standaard aanpassen of uitbreiden wordt de keuze voorgelegd aan de beheercommissie. Vervolgens wordt de issue afgehandeld, met de uitwerking klaar in de beheeromgeving voor de release van een concept-publicatie. Issues worden afgehandeld volgens [dit protocol](https://github.com/nl-digigo/NLCS/blob/main/instructies/RASCI%20Github%20issues%20NLCS.pdf). +#### Tegenvoorstel +Als een door een inhoudelijke werkgroep of gebruiker ingediende uitbreiding van NLCS volgens de expertcommissie niet past binnen de werking van NLCs, doet zij een tegenvoorstel zodat de werkgroep richting krijgt voor het uitwerken van een voorstel dat wel binnen de scope van NLCS past. + ### Publicatie concept -Na de afhandeling van issues wordt het concept van de release gepubliceerd. +Na positief adview van de expertcommissie worden issues verwerkt en wordt een concept-release gepubliceerd. Hierna worden drie parallelle trajecten gelijktijdig opgestart: + +* Openbare consultatie +* Test-implementatie softwareleveranciers +* + + ### Openbare consultatie Een openbare consultatie wordt gehouden om feedback te verzamelen van belanghebbenden. @@ -23,14 +46,14 @@ Een openbare consultatie wordt gehouden om feedback te verzamelen van belanghebb Vóór de definitieve publicatie wordt samen met de leveranciers getest, inclusief compatibiliteit met tekeningen van de twee eerdere versies die vanaf dat moment worden ondersteund. ### Verwerken issues -Eventuele nieuwe issues die tijdens de testfase naar voren komen, worden verwerkt. +Eventuele nieuwe issues die tijdens de testfase naar voren komen, worden door de expertcommissie beoordeeld. Bij een positief advies worden de issue verwerkt voor de definitieve release. -### Definitieve publicatie +### Publicatie definitief Na succesvolle tests en verwerking van issues wordt de definitieve versie gepubliceerd. ### Implementatieperiode -Er volgt een implementatieperiode waarin CAD softwareleveranciers zich voorbereiden op de overgang naar de nieuwe versie. +Er volgt een implementatieperiode waarin CAD softwareleveranciers zich voorbereiden op de overgang naar de nieuwe versie. Deze periode kan reltief kort duren, omdat de concept-release al eerder is geimplementeerd en getest. -### Officiële release -Op het vastgestelde moment van officiële release kunnen eindgebruikers van CAD-software aan de slag met de nieuwe versie van de standaard. +### Formele release +Op het vastgestelde moment van formele release kunnen eindgebruikers van CAD-software aan de slag met de nieuwe versie van de standaard. diff --git a/docs/releaseprotocol/h/media/Releaseprotocol.png b/docs/releaseprotocol/h/media/Releaseprotocol.png new file mode 100644 index 00000000..8daee430 Binary files /dev/null and b/docs/releaseprotocol/h/media/Releaseprotocol.png differ diff --git a/docs/releaseprotocol/index.html b/docs/releaseprotocol/index.html index 57106d57..ae6c873c 100644 --- a/docs/releaseprotocol/index.html +++ b/docs/releaseprotocol/index.html @@ -15,9 +15,6 @@
-
-
-