Documenteer en beargumenteer de keuze voor gebruikte modellen en parameters

Levenscyclus:OntwikkelenImplementatie

Rollen:Ontwikkelaar

Onderwerp:Technische robuustheid en veiligheid

Maatregel

Documenteer en beargumenteer de keuze voor gebruikte modellen en parameters.

Toelichting

Documenteer en beargumenteer tijdens de ontwikkeling van een algoritme de technische keuzes die gemaakt worden voor het betreffende model.

Dit houdt in dat ten minste het volgende wordt gedocumenteerd en beargumenteer:

  • Keuzes voor (hyper)parameters.
  • Keuzes voor het gebruikte model.
  • Of wordt er voldaan aan onderliggende (statistische) aannames van het model?

Onderbouw deze keuzes van parameters en verschillende modellen bijvoorbeeld op basis van de gemeten nauwkeurigheid.

Goede documentatie zorgt er voor dat opgebouwde kennis door kan worden gegeven.

Risico

Wanneer keuzes niet goed worden gedocumenteerd en onderbouwd is later niet te herleiden waarom welke keuzes zijn gemaakt in ontwerp en implementatie, waardoor transparantie en verantwoording niet mogelijk is.

Bijbehorende vereiste(n)

Bekijk alle vereisten

Bronnen

Voorbeelden

Heb je een ander voorbeeld of best practice, laat het ons weten via algoritmes@minbzk.nl