Eindwerk hbo5 programmeren :: Documentatie

In vervolg op mijn vorige post.

De documentatie bij een eindwerk is een kluwen waar we spijtig genoeg door moeten. Het is een hel voor mij en iets waar ik liever mijn tijd niet zou willen insteken. Ik kan begrijpen dat we wat informatie moeten bijhouden en analyses enzoverder moeten documenteren.

Maar de vraag om deze zaken zo gedetailleerd mogelijk te documenteren kan er bij mij niet in. Ik doe een eindwerk hbo5 programmeren. Geen cursus Nederlands. Waarom moet ik dan een voorwoord maken van minimum 1000 woorden? Welke meerwaarde geeft dit aan mijn traject?

Een analyse van minstens 5000 woorden. Tijdens de cursus analyse moesten we alles zo beknopt mogelijk houden zodat alles duidelijk was. Een interview met de sponsor van minimum 1000 woorden. Iedereen weet dat je zulke zaken niet kan forceren. Maar toch limitaties leggen.

Zou de focus niet moeten liggen op de code en de uitwerking hiervan. Waarom de studenten forceren om boeken te schrijven als dit niets bijbrengt?

Ik heb altijd gedacht dat school en opleidingen in het algemeen soms nutteloze aspecten bevatten die niet bijdragen tot de arbeidsmarkt of tot de persoonlijke groei. Dit is weer zo een moment dat ik voel dat mijn gedachtegang correct is. Als programmeur moet je kunnen communiceren. Maar je moet vooral duidelijk kunnen communiceren. Niet alles in het lang en breed uitsmeren. Dus als je kan zeggen "De kip is koud", is dit beter dan "de kip zijn temperatuur is onder de 5 graden". In programmeren wilt een klant een werkend element hoe het achterliggen functioneert interesseert deze persoon meestal niet.

Juist mijn 2 cent