Omschrijving van de vraag/opmerking zelf (bij voorkeur in het format van ‘userstory’):
“Als belanghebbende bij een begrijpelijle systematiek wil ik dat in raamwerk xml's alleen maar verwijzingen geaccepteerd worden zodat raamwerken gewoon blijven werken zoals we de afgelopen 10+ jaar gebruiken en nieuwe toetreders niet in de war raken van tot op dit moment niet gebruikte opties”
Naam, functie (soort gebruiker/rol), diens organisatie, en de soort organisatie van de vraagsteller (stakeholder)
Arne Bruinse Bakker&Spees
Datum en oorsprong van het verzoek*
18-10-2021: schrijven van de documentatie. Functioneel is het geeneens de bedoeling dat er uitgelegd wordt dat je bijv SE's ook mag definieren in een CE omdat dat waarschijnlijk door niemand ondersteund wordt en ook niet slim is. We werken altijd met een verwijzing naar het andere element en nooit met elementen in elementen.
Waarop heeft de vraag betrekking:
b. VISI-raamwerk / COINS referentiekader
Wat is de urgentie )
‘C’ (could have; geen directe hinder; kan een keer worden opgepakt)
Toelichting op de urgentie*
vanuit de herijking wil men als ik het goed begrijp een eenvoudigere standaard. Mijn voorstel is begin om niet gebruikte opties voorgoed op te ruimen.,
‘Open Standaard’
Stel vast of het een ‘bug’ is, of een ‘verbetervoorstel’, of een ‘ander verzoek’
Bug
a. Beschrijf het bestaande gedrag
b. Beschrijf het gewenste gedrag
c. Benoem de stappen om het probleem te reproduceren
Verbetervoorstel
a. Maak de userstory expliciet; mogelijk valt die uiteen in meerdere user stories
(“a list of the types of users who can engage in the activities described in the use case. Actor names should not correspond to job titles”).
b. Beschrijf de randvoorwaarden
(“anything the solution can assume to be true when the use case begins”).
c. Completeer de ‘definiton of ‘done’
(“anything that must be true when the use case is complete”).
d. Beschrijf het verbetervoorstel / of gewenst gedrag
(“the set of steps the actors take to accomplish the goal of the use case. A clear description of what the system should do in response to each user action.”)
e. Beschrijf de voordelen van de verbetering
f. Beschrijf eventuele “Alternate Flows”
(“capture the less common user/system interactions, such as being on a new computer and answering a security question).
g. Beschrijf eventuele “Exception Flows”
(“things that can happen that prevent the user from achieving their goal, such as providing an incorrect username and password).
Ander verzoek
a. Beschrijf de vraag zo gedetailleerd mogelijk
b. Beschrijf de voordelen van het voldoen aan het verzoek
Plaats de gedocumenteerde bug, verbetervoorstel of ander verzoek op de verzamellijst ter prioritering in het kader van de release cyclus (ook op github??)
‘VISI Raamwerk’ of ‘COINS Referentiekader’
Stel vast of het een ‘bug’ is of een ‘verbetervoorstel’ in de standaard, of een probleem bij het gebruik van de standaard (bij VISI: het maken van raamwerken; bij COINS: het gebruik van een referentiekader)
Indien ‘Bug’ of ‘verbetervoorstel’ voor de Standaard
a. Verplaats de vraag naar het bakje ‘Standaard’ en handel daar af conform procedure
Indien probleem bij gebruik
a. Beschrijf de vraag zo gedetailleerd mogelijk (indien alsnog een probleem met de standaard blijkt: zie 2.)
b. Beschrijf de voordelen van het voldoen aan het verzoek
c. Plaats op lijst ter afhandeling (door beheerder van de OS, helpdesk of adviseur)
‘Software’
Betreft het VISI-software of COINS-software
a. Is het een generiek probleem -> zie punt 2
b. Is het een specifiek probleem: informeer (de helpdesk) van de desbetreffende softwareleverancier
c. Informeer eventueel de desbetreffende Expertcommissie en Gebruikerscommissie
Generiek probleem voor de Standaard
a. Verplaats naar het bakje ‘Standaard’ en handel daar af
P.S. Definition of ‘DONE’ (checklist):
De ‘definition of done’ is de checklist van dingen die gedaan moeten zijn voordat je klaar bent met een issue. Er is een generieke definitie, maar ‘done’ moet goed aansluiten bij de vraag. Het kan dus voorkomen dat er nog specifieke dingen aan moeten worden toegevoegd. Dat moet dan gebeuren voordat het oplossen van de vraag start.
• Generieke ‘definition of ‘done’ is helder
• Eventuele specifieke dingen die ook moeten zijn gedaan, moeten aan de generieke definition of ‘done’ worden toegevoegd
De check van de oplossing is dan (voor zover relevant):
• Alle ‘to do’ items voor de User Story zijn voldaan, inclusief de specifiek toegevoegde dingen.
• Relevante gebruikersdocumentatie is gemaakt of aangepast.
• Relevante technische documentatie is bijgewerkt en geactualiseerd.
• De ‘reporter’ heeft het werk geaccepteerd.
• Er is feedback van eindgebruiker(s)/vraagsteller gevraagd/gekregen op het opgeleverde product.
• Alle unit- (bouwer), integratie (productowner) functionele (key users) testen zijn succesvol gedraaid.
• Indien hiervan afgeweken wordt dan is dit opgenomen in de userstory (afwijkingen opgenomen in userstory).
Wat komt er binnen (vraag /opmerking)
‘Open Standaard’
Stel vast of het een ‘bug’ is, of een ‘verbetervoorstel’, of een ‘ander verzoek’
Bug a. Beschrijf het bestaande gedrag b. Beschrijf het gewenste gedrag c. Benoem de stappen om het probleem te reproduceren
Verbetervoorstel a. Maak de userstory expliciet; mogelijk valt die uiteen in meerdere user stories (“a list of the types of users who can engage in the activities described in the use case. Actor names should not correspond to job titles”). b. Beschrijf de randvoorwaarden (“anything the solution can assume to be true when the use case begins”). c. Completeer de ‘definiton of ‘done’ (“anything that must be true when the use case is complete”). d. Beschrijf het verbetervoorstel / of gewenst gedrag (“the set of steps the actors take to accomplish the goal of the use case. A clear description of what the system should do in response to each user action.”) e. Beschrijf de voordelen van de verbetering f. Beschrijf eventuele “Alternate Flows” (“capture the less common user/system interactions, such as being on a new computer and answering a security question). g. Beschrijf eventuele “Exception Flows”
(“things that can happen that prevent the user from achieving their goal, such as providing an incorrect username and password).
Ander verzoek a. Beschrijf de vraag zo gedetailleerd mogelijk b. Beschrijf de voordelen van het voldoen aan het verzoek
Plaats de gedocumenteerde bug, verbetervoorstel of ander verzoek op de verzamellijst ter prioritering in het kader van de release cyclus (ook op github??)
‘VISI Raamwerk’ of ‘COINS Referentiekader’
Stel vast of het een ‘bug’ is of een ‘verbetervoorstel’ in de standaard, of een probleem bij het gebruik van de standaard (bij VISI: het maken van raamwerken; bij COINS: het gebruik van een referentiekader)
Indien ‘Bug’ of ‘verbetervoorstel’ voor de Standaard a. Verplaats de vraag naar het bakje ‘Standaard’ en handel daar af conform procedure
Indien probleem bij gebruik a. Beschrijf de vraag zo gedetailleerd mogelijk (indien alsnog een probleem met de standaard blijkt: zie 2.) b. Beschrijf de voordelen van het voldoen aan het verzoek c. Plaats op lijst ter afhandeling (door beheerder van de OS, helpdesk of adviseur)
‘Software’
Betreft het VISI-software of COINS-software a. Is het een generiek probleem -> zie punt 2 b. Is het een specifiek probleem: informeer (de helpdesk) van de desbetreffende softwareleverancier c. Informeer eventueel de desbetreffende Expertcommissie en Gebruikerscommissie
Generiek probleem voor de Standaard a. Verplaats naar het bakje ‘Standaard’ en handel daar af
P.S. Definition of ‘DONE’ (checklist):
De ‘definition of done’ is de checklist van dingen die gedaan moeten zijn voordat je klaar bent met een issue. Er is een generieke definitie, maar ‘done’ moet goed aansluiten bij de vraag. Het kan dus voorkomen dat er nog specifieke dingen aan moeten worden toegevoegd. Dat moet dan gebeuren voordat het oplossen van de vraag start. • Generieke ‘definition of ‘done’ is helder • Eventuele specifieke dingen die ook moeten zijn gedaan, moeten aan de generieke definition of ‘done’ worden toegevoegd
De check van de oplossing is dan (voor zover relevant): • Alle ‘to do’ items voor de User Story zijn voldaan, inclusief de specifiek toegevoegde dingen. • Relevante gebruikersdocumentatie is gemaakt of aangepast. • Relevante technische documentatie is bijgewerkt en geactualiseerd. • De ‘reporter’ heeft het werk geaccepteerd. • Er is feedback van eindgebruiker(s)/vraagsteller gevraagd/gekregen op het opgeleverde product. • Alle unit- (bouwer), integratie (productowner) functionele (key users) testen zijn succesvol gedraaid. • Indien hiervan afgeweken wordt dan is dit opgenomen in de userstory (afwijkingen opgenomen in userstory).