My Projects: het "User" gedeelte

In dit deel van de verzameling zitten vier typen documenten:

  • specificaties/requirements

  • achtergrondmateriaal en andere documenten

  • wijzigingsverzoeken / beschrijvingen

  • probleemrapporten / beschrijvingen

De organisatie van de site en de navigatie over de onderdelen is elders beschreven. Wat hier volgt gaat meer over de bedoelde inhoud van de afzonderlijke soorten documenten.

Specificaties/requirements

Deze documenten bevatten aanwijzingen die componenten beschrijven die gebouwd moeten worden of voorwaarden waaran deze moeten voldoen.

De volgende informatie-onderdelen zijn hier bedacht:

  • een titel

  • een korte (bij voorkeur éénregelige) beschrijving van het project

  • een beschrijving van de gewenste functionaliteit (of aanvulling daarop)

  • een beschrijving van hoe het eruit moet zien

  • een beschrijving van de gewenste output

  • een korte (bij voorkeur éénregelige) beschrijving van the supposed benefits

  • een korte (bij voorkeur éénregelige) beschrijving van allowed costs

  • een beschrijving van wat er verder nog beschreven moet worden

Relaties

Specificatie/requirement documents verwijzen niet naar andere documenten; er kan wel naar verwezen worden vanuit gebruikerstaken en functionele processen, om aan te geven dat deze de bedoeld zijn om specificaties te realiseren of de requirements te vervullen.

Achtergrondmateriaal en andere documenten

Dit type document geeft de mogelijkheid om een willekeurige tekst toe te voegen of een verwijzing naar een document elders vast te leggen. In beide gevallen kunnen een titel en een korte beschrijving worden toegevoegd.

De volgende informatie-onderdelen zijn hier bedacht:

  • een titel

  • een korte (bij voorkeur éénregelige) beschrijving van het project

  • een link naar een ge-upload document

  • een vrij toe te voegen tekst

Relaties

Er zijn geen verwijzingen voorzien van of naar deze documenten.

Wijzigingsverzoeken / beschrijvingen

Dit type document kan gemaakt worden wanneer de bestaande functionaliteit niet voldoende is. Het lijkt op een speificatie/requirement, maar bouwt daar op voort in plaats van iets nieuws te beschrijven.

De volgende informatie-onderdelen zijn hier bedacht:

  • een volgnummer dat automatisch gegenereerd wordt

  • een aanmaakdatum (niet op het scherm getoond)

  • een indicatie of het afgehandeld is

  • een afhandeldatum (niet op het scherm getoond)

  • een korte (bij voorkeur éénregelige) beschrijving van de wens

  • een volledige beschrijving

  • ruimte voor extra opmerkingen

  • de sleutel van de gerelateerde actie in het ticket registratie systeem (wordt niet op het scherm getoons)

  • het nummer van die actie zoals dat ook wordt getoond op de schermen van het ticket registratie systeem

Wijzigingsverzoeken verwijzen niet naar andere documenten (ook niet naar de specs waar ze een aanvulling op zijn?); er kan naar verwezen worden vanuit functionale taken, processen en data model entititeiten - eigenlijk de omgekeerde verwijzing van de vraag tussen haakjes.

Probleemrapporten / beschrijvingen

Dit type document kan gemaakt worden wanneer de bestaande functionaliteit niet correct werkt zoals aangegeven in de specificaties/requirements die het beschrijven.

De volgende informatie-onderdelen zijn hier bedacht:

  • een volgnummer dat automatisch gegenereerd wordt

  • een aanmaakdatum (niet op het scherm getoond)

  • een indicatie of het afgehandeld is

  • een afhandeldatum (niet op het scherm getoond)

  • een korte (bij voorkeur éénregelige) beschrijving van het issue

  • een volledige beschrijving

  • ruimte voor extra opmerkingen

  • de sleutel van de gerelateerde actie in het ticket registratie systeem (wordt niet op het scherm getoons)

  • het nummer van die actie zoals dat ook wordt getoond op de schermen van het ticket registratie systeem

Er zijn momenteel geen relaties gedefinieerd met andere documenttypen (hoewel een verwijzing naar de specs denkbaar is).