Skip to content

Commit

Permalink
update releaseprotocol
Browse files Browse the repository at this point in the history
  • Loading branch information
ElisabethKloren committed Nov 21, 2023
1 parent f446a09 commit e9d5b14
Show file tree
Hide file tree
Showing 6 changed files with 61 additions and 30 deletions.
16 changes: 16 additions & 0 deletions docs/managementmanual/h/1.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,22 @@
Dit document beschrijft de beheerhandleiding van de <abbr title="Nederlandse CAD-standaard">NLCS</abbr>.


## 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

<div class="issue" data-number="159"></div>
Expand Down
17 changes: 1 addition & 16 deletions docs/releaseprotocol/config.js
Original file line number Diff line number Diff line change
@@ -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",
Expand All @@ -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",
},

},
};
12 changes: 11 additions & 1 deletion docs/releaseprotocol/h/0-samenvatting.md
Original file line number Diff line number Diff line change
@@ -1 +1,11 @@
Dit document beschrijft het releaseprotocol van NLCS, de stappen die worden ondernomen om te komen tot een nieuwe release
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).
43 changes: 33 additions & 10 deletions docs/releaseprotocol/h/1.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,18 +3,41 @@
## Doel documentatie
Dit document beschrijft het releaseprotocol van de <abbr title="Nederlandse CAD-standaard">NLCS</abbr>.

<figure>
<img src="./h/media/Releaseprotocol.png" alt="flowchart van het releaseprotocol zoals beschreven in dit document">
<figcaption>Releaseprotocol</caption>
</figure>

## 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.
Expand All @@ -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.

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 0 additions & 3 deletions docs/releaseprotocol/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,6 @@
<section id="abstract" data-include-format="markdown" data-include="h/0-samenvatting.md"></section>
<section id="sotd"></section>
<section class="informative" data-include-format="markdown" data-include="h/1.md"></section>
<section id="conformance"></section>
<section id="index"></section>
<section class="appendix" id="issue-summary"></section>
</body>

</html>

0 comments on commit e9d5b14

Please sign in to comment.