nl-digigo / NLCS

Technische documentatie en issues NLCS
Creative Commons Attribution 4.0 International
2 stars 0 forks source link

Stappenplan om tot Release NLCS Stedelijk Spoor te komen toevoegen als Milestones #252

Closed CorneHelmons closed 6 months ago

CorneHelmons commented 6 months ago

1 Objectenlijst vaststellen 2 Symbolen bibliotheek vaststellen 3 Aanvullende bibliotheken (Linestyles, Arceringen) vaststellen 4 Importeren als POC in tools leveranciers (TPG, Arkance, Cad&Company zijn in gebruik bij SS beheerders) 5 Bug fixes NLCS Stedelijk Spoor 6 Release NLCS Stedelijk Spoor

Bespreken met Elisabeth of dit stappenplan voor meerdere milestones opgenomen kan worden.

ElisabethKloren commented 6 months ago

Goed idee, ik heb bovenstaande details opgenomen in het Releaseprotocol en kom dan tot de volgende stappen:

Wijzigingsvoorstel uitwerken

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.

Topevoegen of wijzigen van objecten:

  1. Laagtabellen
  2. Symbolen bibliotheek
  3. Aanvullende bibliotheken (Linestyles, Arceringen)

Release volgen in Github

Voorafgaand aan een potentiële release wordt deze in GitHub opgenomen als Milestone. De issues die in de release worden afgehandeld, worden gekoppeld aan deze milestone.

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.

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 positief adview van de expertcommissie worden issues verwerkt en wordt een concept-release gepubliceerd. Hierna worden drie parallelle trajecten gelijktijdig opgestart:

Openbare consultatie

Een openbare consultatie wordt gehouden om feedback te verzamelen van belanghebbenden.

Test-implementatie softwareleveranciers

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 door de expertcommissie beoordeeld. Bij een positief advies worden de issue verwerkt voor de definitieve release.

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. Deze periode kan reltief kort duren, omdat de concept-release al eerder is geimplementeerd en getest.

Formele release

Op het vastgestelde moment van formele release kunnen eindgebruikers van CAD-software aan de slag met de nieuwe versie van de standaard.

Niet opgenomen als milestones, die worden gebruikt op 1 niveau hoger, wel opgenomen als stappen in de issue van het project: #184