Feedback PCB-producten

[BobNonnekens]

Feedback van gebruikers levert een belangrijke bijdrage aan het voortdurend verbeteren van de PCB-producten (eisensets, standaard-contractdocumenten). De feedback wordt hier in GitHub aangeleverd in de vorm van een 'Issue'. Iedere geregistreerde mag Issues aanmaken (lees: feedback leveren). Registratie ('Sign on') is verplicht en inloggen ('Sign in') noodzakelijk.

Hierbij hanteren we een aantal spelregels:

• Als je een Issue aanmaakt, begin je titel dan met de kreet: 'Feedback' met daarna een beknopte aanduiding van het onderwerp.
• Beschrijf in de inhoud (onder de tab 'Write') de volgende punten:
  • _Betreft PCB-product_
  • Betreft onderdeel (zo expliciet mogelijk zoals pagina, alinea, eisnummer, stap, etc.)
  • Verbetervoorstel
  • Beoogd doel van de verbetering (‘als we dit niet doen, dan…’, ‘hierdoor kunnen we…’, etc.)
• Selecteer in de kolom rechts (onder het kopje 'label') het label met het onderwerp waarop je feedback betrekking heeft.
• De gebruikers van de PCB-GitHub kunnen hierop reageren .
• CROW zal als procesfacilitator van het PCB samen met het voor de feedback relevante Kennisteam, de volgende acties nemen: -De urgentie van de feedback beoordelen. a. Bij mogelijk onwettige eisen of wijziging in Wet- en regelgeving beoordeelt CROW direct de impact en legt een verbeteringsvoorstel ter vaststelling voor bij het relevante kennisteam van het PCB. Na vaststelling door het kennisteam beoordeelt het PCB Kernteam de vrijgave tot publicatie. CROW verzorgt dan de publicatie en de communicatie. b. Bij kleine fouten, omissies, voortschrijdende kennis en/of andere verbetervoorstellen beslist het PCB Kernteam halfjaarlijks welke voorstellen door het relevante kennisteam uitgewerkt moeten worden in een geactualiseerde eisenset. Na vaststelling door het kennisteam beoordeelt het PCB Kernteam de vrijgave tot publicatie. CROW verzorgt dan de publicatie en de communicatie. Op basis van bovenstaande kan het dus ook gebeuren dat de feedback / het voorstel niet als noodzakelijke wijziging onderschreven wordt. Dit zal aan de melder uitgelegd worden. Hierna wordt het betreffende issue gesloten.

Feedback op bovenomschreven procedure graag in een reactie op dit Issue

[ElisabethKloren]

Ik zorg dat die handleiding in het Beheerplan komt te staan en maak dan een verwijzing vanaf de voorpagina van de Github

[ElisabethKloren]

Alle issues zijn feedback, met labels kunnen we vervolgens aangeven over welk PCB product de issue gaat. Voorstel labels:

1 label per eisenset (Wegen, Groen, enzovoorts) 1 label per format 1 label over beheer PCB (beheerplan, uitvoering beheer door CROW, Kenteam en Stuurgroep) 1 label voor LinkedData / digitalisering 1 label voor de website

[ElisabethKloren]

Dus extra spelregel: "selecteer het label met het onderwerp waarop je feedback betrekking heeft"

[BobNonnekens]

Uitstekend Elisabeth, ik maak de extra labels aan <_done_> en verwijder het eerste punt bij de inhoudelijke beschrijving: 'Betreft PCB-product' <_done_>. Extra spelregel toevoegen <_done_>

NB. als gevolg van bovenstaande het label bij dit issue gewijzigd in 'Feedback op PCB-Beheer'.

[ElisabethKloren]

Over een kwartiertje (verversingstijd github) staat de feedbackprocedure ook in het beheerplan: http://docs.crow.nl/PCB/beheerplan/#feedbackprocedure

[RiX012]

Jullie kunnen het jezelf nog makkelijker maken door een Issue template te maken! :) https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/configuring-issue-templates-for-your-repository

[ElisabethKloren]

@BobNonnekens ik heb een standaard feedback issue template gemaakt

[BobNon]

Daarmee zijn de eerste twee bullets van deze spelregels komen te vervallen. De gebruiker kan volstaan met klikken op het groene vakje 'New Issue' en dan op het groene vakje 'Get started'.