Skip to content

Commit

Permalink
update protocol afhandelen gebruikerswens
Browse files Browse the repository at this point in the history
  • Loading branch information
ElisabethKloren committed Dec 21, 2023
1 parent 56ae7ba commit bbb5cc7
Show file tree
Hide file tree
Showing 9 changed files with 287 additions and 24 deletions.
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,12 +7,12 @@ Deze repository is de locatie voor technische documentatie en het inbrengen en o
* [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).
* [Gebruikerswens / issue indienen](https://github.com/nl-digigo/NLCS/issues)
* [Protocol afhandelen gebruikerswensen](https://nl-digigo.github.io/NLCS/protocolissues)

## Voor ontwerpers en tekenaars
* [Uitleg standaard](https://nl-digigo.github.io/NLCS/functionalspecification): Functionele specificatie van NLCS met daarin de toelichting op het beoogd doel en de werking van de standaard
* [Tekeningen en modellen maken](https://nl-digigo.github.io/NLCS/requirementscadmodels/)
* [Uitleg standaard](https://nl-digigo.github.io/NLCS/functionalspecification): De uitleg van de standaard met daarin de toelichting op het beoogd doel en de werking van de standaard
* [Eisen aan tekeningen en modellen](https://nl-digigo.github.io/NLCS/requirementscadmodels/)
* [Voorbeeldtekeningen](https://www.nl-digigo.nl/p/432/Leren-van-anderen)

### Zelf applicatie inrichten
Expand Down
13 changes: 6 additions & 7 deletions docs/functionalspecification/h/0-samenvatting.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,12 @@
Dit document bevat de uitleg van de standaard, de functionele specificatie van NLCS met daarin de toelichting op het beoogd doel en de werking van de standaard.
Dit document bevat de uitleg van de standaard met daarin de toelichting op het beoogd doel en de werking van de standaard.

Dit document sluit aan op de volgende documenten:

* [Toelichting informatiemodel](https://bimloket.github.io/NLCS/code_documentation/): De toelichting op de uitgangspunten en modelleringswijze van het informatiemodel in linked data
* [Toelichting code, datasets, query's](https://bimloket.github.io/NLCS/howtoquery/): Een gebruikershandleiding om
* [Relaties tot andere standaarden](https://bimloket.github.io/NLCS/ontologyalignments/): documentatie van de ontology alignments (mappings waar een computer mee kan redeneren) of voorbereidingen daartoe met andere standaarden, waaronder IMGeo (voor BGT kaartinformatie) en het GWSW (Gemeentelijk woordenboek stedelijk water)
* [Uitwisselafspraken](https://bimloket.github.io/NLCS/representations/): Nu nog slechts een gebruikerswens. Een nader te bepalen set afspraken over de uitwisseling van modellen en tekeningen in open formaten, met daaraan toegevoegd objectinformatie
* [Eisen aan tekeningen en modellen](https://bimloket.github.io/NLCS/requirementscadmodels/)
* [Eisen aan software-implementatie](https://bimloket.github.io/NLCS/requirementssoftware/)

* Uitleg standaard: voorliggend document
* [Eisen aan tekeningen en modellen](https://nl-digigo.github.io/NLCS/requirementscadmodels/)
* [Voorbeeldtekeningen](https://www.nl-digigo.nl/p/432/Leren-van-anderen)



<figure>
Expand Down
10 changes: 9 additions & 1 deletion docs/managementmanual/h/0-samenvatting.md
Original file line number Diff line number Diff line change
@@ -1 +1,9 @@
Dit document bevat de beheerhandleiding van NLCS
Dit document bevat de beheerhandleiding van NLCS en is onderdeel van de volgende documentenreeks:


* [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: voorliggend document
* [Releaseprotocol NLCS](https://nl-digigo.github.io/NLCS/releaseprotocol)
* [Gebruikerswens / issue indienen](https://github.com/nl-digigo/NLCS/issues)
* [Protocol afhandelen gebruikerswensen](https://nl-digigo.github.io/NLCS/protocolissues)
10 changes: 0 additions & 10 deletions docs/managementmanual/h/1.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,19 +7,9 @@ Dit document beschrijft de beheerhandleiding van de <abbr title="Nederlandse CAD
## 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
24 changes: 24 additions & 0 deletions docs/protocolissues/config.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
var respecConfig = {
// => https://github.com/stichting-crow/respec/wiki
specStatus: "DEF",
shortName: "NLCS/protocolissues",
specType: "beheerdocumentatie", // vrije tekst, kleine letter
imprint: "bimloket",
editors: [
// alleen `name` is verplicht, https://respec.org/docs/#person
{
name: "Elisabeth de Vries",
company: "DigiGO",
},
],
authors: [
// alleen `name` is verplicht, https://respec.org/docs/#person
{
name: "Elisabeth de Vries",
company: "DigiGO",
},
],
github: "https://github.com/nl-digigo/NLCS",
license: "cc-by",
lint: { "no-unused-dfns": false },
};
12 changes: 12 additions & 0 deletions docs/protocolissues/h/0-samenvatting.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
Dit document beschrijft het protocol voor het afhandelen gebruikerswensen.

Dit protocol is onderdeel van een reeks documenten over het beheer van NLCS:

## Beheer

* [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: voorliggend document
209 changes: 209 additions & 0 deletions docs/protocolissues/h/1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,209 @@
# Inleiding


Dit document beschrijft het protocol voor het afhandelen van gebruikerswensen die starten met binnenkomende issues.
Het doel van het protocol is de beschrijving van hoe issues op de GitHub van NLCS leiden tot besluiten over de standaard.


## Protocol
<table style="width: 100%; border-collapse: collapse;">
<colgroup>
<col style="width: 15%;">
<col style="width: 30%;">
<col style="width: 15%;">
<col style="width: 25%;">
<col style="width: 5%;">
<col style="width: 5%;">
<col style="width: 5%;">
</colgroup>
<tr>
<th colspan="7" style="background-color: #3498db; color: white;">Protocol afhandelen issues</th>
</tr>
<tr>
<th style="width: 15%;">Input: informatie in issue</th>
<th style="width: 30%;">Processtap</th>
<th style="width: 15%;">Issue komt op naam van:</th>
<th style="width: 25%;">Comments, op te nemen bij de issue</th>
<th style="width: 5%; transform: rotate(-90deg);"></th>
<th style="width: 5%; transform: rotate(-90deg);"></th>
<th style="width: 5%; transform: rotate(-90deg);"></th>
</tr>
<tr>
<td colspan="3"></td>
<td colspan="4"></td>
</tr>
<tr>
<td></td>
<td style="background-color: #3498db; color: white;">0. Issue komt binnen op GitHub</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td></td>
<td><div style="display: flex; align-items: center; justify-content: center; height: 100%;">&#8595;</div></td>
<td colspan="5"></td>
</tr>
<tr>
<td>GitHub issue waar nog geen naam bij staat voor verwerking en geen labels</td>
<td style="background-color: #3498db; color: white;">1. Wekelijkse controle op binnenkomende issues</td>
<td></td>
<td>@indiener, bedankt voor je vraag, we gaan ermee aan de slag</td>
<td><b>R</b></td>
<td>S</td>
<td>I</td>
</tr>
<tr>
<td></td>
<td><div style="display: flex; align-items: center; justify-content: center; height: 100%;">&#8595;</div></td>
<td colspan="5"></td>
</tr>
<tr>
<td></td>
<td style="background-color: #3498db; color: white;">2. Vraag om aanpassing informatiemodel of documentatie</td>
<td>Elisabeth</td>
<td></td>
<td><b>R</b></td>
<td>S</td>
<td>I</td>
</tr>
<tr>
<td></td>
<td><div style="display: flex; align-items: center; justify-content: center; height: 100%;">&#8595;</div></td>
<td colspan="5"></td>
</tr>
<tr>
<td></td>
<td style="background-color: #3498db; color: white;">3. Vraag om aanpassen of toevoegen objecten in NLCS</td>
<td>Niels</td>
<td></td>
<td>S</td>
<td><b>R</b></td>
<td>I</td>
</tr>
<tr>
<td></td>
<td><div style="display: flex; align-items: center; justify-content: center; height: 100%;">&#8595;</div></td>
<td colspan="5"></td>
</tr>
<tr>
<td><div style="display: flex; align-items: center; justify-content: center; height: 100%;">Nee <br> naar 6 &#8595;</div></td>
<td style="background-color: #808080; color: white;">4. Besluit: moet om opheldering of besluit worden gevraagd?</td>
<td>Elisabeth</td>
<td>@indiener, kun jij mij dit nader toelichten?</td>
<td><b>R</b></td>
<td>S</td>
<td>I</td>
</tr>
<tr>
<td></td>
<td><div style="display: flex; align-items: center; justify-content: center; height: 100%;">Ja &#8595;</div></td>
<td colspan="5"></td>
</tr>
<tr>
<td></td>
<td style="background-color: #3498db; color: white;">5. Ophelderen gebruikersvraag</td>
<td>Elisabeth</td>
<td>Duidelijker beschreven gebruikersvraag opgenomen bij de issue</td>
<td><b>R</b></td>
<td>S</td>
<td>I</td>
</tr>
<tr>
<td></td>
<td><div style="display: flex; align-items: center; justify-content: center; height: 100%;">&#8595;</div></td>
<td colspan="5"></td>
</tr>
<tr>
<td><div style="display: flex; align-items: center; justify-content: center; height: 100%;">Nee <br> naar 9 &#8595;</div></td>
<td style="background-color: #808080; color: white;">6. Besluit: moet de issue worden uitgewerkt naar een oplossing?</td>
<td>Elisabeth</td>
<td>Inschatting impact: hoog / middel / laag, op basis daarvan toekennen aan Milestone voor een release, of opnemen als onderdeel van een ontwikkelproject</td>
<td><b>R</b></td>
<td>S</td>
<td>I</td>
</tr>
<tr>
<td></td>
<td><div style="display: flex; align-items: center; justify-content: center; height: 100%;">Ja &#8595;</div></td>
<td colspan="5"></td>
</tr>
<tr>
<td></td>
<td style="background-color: #3498db; color: white;">7. Uitwerken voorstel aanpassing informatiemodel of documentatie</td>
<td>Elisabeth</td>
<td>Bij de issue staat hoe dit wordt meegenomen in een volgende release van NLCS</td>
<td><b>R</b></td>
<td>S</td>
<td>I</td>
</tr>
<tr>
<td></td>
<td><div style="display: flex; align-items: center; justify-content: center; height: 100%;">&#8595;</div></td>
<td colspan="5"></td>
</tr>
<tr>
<td></td>
<td style="background-color: #3498db; color: white;">8. Uitwerken voorstel aanpassen of toevoegen objecten in NLCS</td>
<td>Niels</td>
<td>Bij de issue staat hoe dit wordt meegenomen in een volgende release van NLCS</td>
<td>S</td>
<td><b>R</b></td>
<td>I</td>
</tr>
<tr>
<td></td>
<td><div style="display: flex; align-items: center; justify-content: center; height: 100%;">&#8595;</div></td>
<td colspan="5"></td>
<tr>
<td><div style="display: flex; align-items: center; justify-content: center; height: 100%;">Nee <br> naar 11 &#8595;</div></td>
<td style="background-color: #808080; color: white;">9. Besluit volgens het Releaseprotocol: wordt NLCS aangepast?</td>
<td>Elisabeth </td>
<td>"Issue wordt opgenomen in versie N + 1 <br> Issue wordt niet opgenomen in NLCS vanwege besluit X" </td>
<td><b>R</b></td>
<td>S</td>
<td>I</td>
</tr>
<tr>
<td></td>
<td><div style="display: flex; align-items: center; justify-content: center; height: 100%;">&#8595;</div></td>
<td colspan="5"></td>
<tr>
<td></td>
<td style="background-color: #3498db; color: white;">10. Issue wordt verwerkt</td>
<td>Elisabeth/Niels</td>
<td>De issue is gesloten. De issue verwerkt in de beheeromgeving en in de documentatie en wordt gepubliceerd in de eerstvolgende release <td>
<td><b>R</b></td>
<td>S</td>
<td>I</td>
</tr>
<tr>
<td></td>
<td><div style="display: flex; align-items: center; justify-content: center; height: 100%;">&#8595;</div></td>
<td colspan="5"></td>
</tr>
<tr>
<td></td>
<td style="background-color: #3498db; color: white;">11. Issue wordt afgesloten</td>
<td>Elisabeth/Niels</td>
<td>Issue wordt afgesloten met een melding</td>
<td><b>R</b></td>
<td>S</td>
<td>I</td>
</tr>
<tr>
</table>



## Toeliching RASCI
Het protocol geeft een invulling aan RASCI. RASCI is een acroniem dat wordt gebruikt om de rollen en verantwoordelijkheden van individuen binnen een team of organisatie te definiëren met betrekking tot een specifieke taak of proces. RASCI is een handige tool voor het helder definiëren van rollen en verantwoordelijkheden, waardoor teamleden beter begrijpen wie wat doet in een bepaald project of proces.

De volgende RASCI-afkortingen worden gebruikt om de rol van de product manager, beheercommissie NLCS en de Expertcommissie NLCS aan te duiden in de 5e, 6e en 7e kolom van de tabel:
* R (Responsible): De persoon of personen die verantwoordelijk zijn voor het uitvoeren van de taak. Deze personen zijn direct betrokken bij de uitvoering en voltooiing van de activiteit.
* A (Accountable): De persoon die uiteindelijk verantwoordelijk is voor het resultaat van de taak. Deze persoon wordt vaak aangeduid als de "eigenaar" en neemt de eindbeslissingen.
* S (Support): Individuen die ondersteuning bieden aan degenen die verantwoordelijk zijn voor de uitvoering van de taak. Ze kunnen advies geven, middelen verstrekken of betrokken zijn bij bepaalde aspecten van het proces.
* C (Consulted): Personen die geraadpleegd moeten worden voordat beslissingen worden genomen of acties worden ondernomen. Hun input en expertise zijn waardevol voor het proces.
* I (Informed): Personen die op de hoogte moeten worden gehouden van de voortgang van de taak, maar die geen directe betrokkenheid hebben bij de uitvoering ervan. Ze worden op de hoogte gesteld van beslissingen en resultaten.
20 changes: 20 additions & 0 deletions docs/protocolissues/index.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
<!DOCTYPE html>
<html lang="nl">

<head>
<meta charset='utf-8'>
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
<!-- Pas hier de titel van het document aan -->
<title>Protocol afhandelen issues / gebruikerswensen</title>
<script src="config.js" class="remove"></script>
<script src='https://cdn.jsdelivr.net/gh/stichting-crow/respec@latest/builds/respec-stichting-crow.js' async class='remove'></script>
</head>

<body>
<!-- Op https://github.com/stichting-crow/respec/wiki staat een beknopte handleiding voor ReSpec. -->
<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>
</body>

</html>
5 changes: 3 additions & 2 deletions docs/releaseprotocol/h/0-samenvatting.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,11 @@ Dit document beschrijft het releaseprotocol van NLCS, de stappen die worden onde

Dit protocol is onderdeel van een reeks documenten over het beheer van NLCS:

## Beheer

* [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)
* Releaseprotocol NLCS: voorliggend document
* [Gebruikerswens indienen](https://nl-digigo.github.io/NLCS/protocolissues)
* [Protocol afhandelen gebruikerswensen](https://github.com/nl-digigo/NLCS/blob/main/instructies/RASCI%20Github%20issues%20NLCS.pdf).

0 comments on commit bbb5cc7

Please sign in to comment.