BLOG

[DUTCH TRANSLATION]
Afgelopen vrijdag 25 september 2009 heb ik (Stephan Smetsers) samen met Alex Faessen een bijeenkomst van de stichting dotNed bezocht. Deze bijeenkomst werd gehost door Afas ERP software in Leusden. Het betrof een extra ingeroosterde bijeenkomst omdat het de organisatie gelukt was om Scott Guthrie van Microsoft te strikken voor het geven van twee geweldige presentaties. Scott is Corporate Vice President .NET Developer Platform bij Microsoft.

[DUTCH TRANSLATION]
Eind vorig jaar heb ik in Barcelona de TechEd EMEA 2008 bezocht. Het hoofdonderwerp van het Microsoft congres, dat twee weken duurde was uiteraard het .NET framework. Als ik de vergelijking moet maken met een kind, dat een rondleiding krijgt in een cholocade-fabriek, dan was ik voortdurend aan het zoeken naar de spreker, die zou gaan vertellen over de nieuwste en lekkerste snoepjes, die er het komende jaar op de markt gaan verschijnen. Al snel kwam ik erachter dat Microsoft van een aantal snoepjes de verpakking heeft aangepast. Waarom nou toch...? Zijn ze nu helemaal gek geworden...? Die ene verpakking was juist zo handig. Waarom gaan ze die nu juist aanpassen?

Years ago I stopped competitive swimming and switched over to water polo because I felt very attracted to practicing a sport in a team. Nowadays I don’t do anything else. I still practice a sport in a team but now I call it “work” and water polo is replaced by software-development. The players in my team are my colleagues. But where is the scoreboard?

[DUTCH TRANSLATION]
Jaren geleden ben ik ooit gestopt met wedstrijdzwemmen om me bezig te gaan houden met waterpolo. Het gaan sporten in teamverband trok me enorm. Nu jaren later doe ik niet veel anders. Nog steeds sport ik in teamverband, alleen noem ik de sport nu ‘werk' en is waterpolo ingeruild voor ‘software-ontwikkeling'. Mijn teamspelers zijn mijn collegas. Maar waar is het scorebord?

Why does a developer feel often uncomfortable being asked for the documentation of his software? Though this question will not be answered in this article, it will be explained how in a simple way it is possible to generate automatically (technical) documentation of software.

[DUTCH TRANSLATION]
Waarom verschijnt er altijd een ongemakkelijke glimlach op het gezicht van een ontwikkelaar als er gevraagd wordt of zijn software gedocumenteerd is? Hoewel deze vraag niet wordt beantwoordt in dit artikel, zal er worden uitgelegd hoe het op eenvoudige wijze mogelijk is om (technische) documentatie van software automatisch te laten genereren.