Commentaar in code: Laten we het gewoon in het engels doen

Als ik naar een congres lees ik vooraf welke talks er gegeven worden. Als daar iets tussen staat wat ik tof vind heb ik daar vaak een hoge verwachting van, iets wat zelden blijkt te kloppen.

Bij mij blijven juist de kleine dingen vaak hangen, omdat ze me aan het denken zetten. Zo ook iets wat ik opving tijdens een talk van Sander Hoogendoorn op de Full Stack Conference in Nieuwegein.

Hoogendoorn vertelde over een oude situatie bij een grote verzekeraar die een zeer complex programma - geschreven in cobol - in-house had ontwikkeld. Dit programma moest worden gemigreerd, een taak die was toegewezen aan een extern team in India. Hier kwam het probleem: de variabelen, functienamen en commentaren waren allemaal in het Nederlands geschreven, wat het voor het team in India onmogelijk maakte om de code te begrijpen.

Dit zette me aan het denken. In het team waarin ik werk, hebben we geen duidelijke regels voor taalgebruik in onze code. Functienamen en variabelen schrijven we altijd in het Engels, maar commentaren en pull requests vaak in het Nederlands, ook door mijzelf.

Conclusie:

Ik heb nooit stilgestaan bij het feit dat mijn documentatie / comments mogelijk door mensen gelezen worden die geen Nederlands spreken. Misschien zit ik te veel in mijn eigen bubbel, omdat alle mensen waarmee ik werk dezelfde taal spreken.
Misschien wordt het nooit relevant. Maar als we de keuze hebben om de documentatie in het Engels te schrijven, waarom zouden we dat dan niet gewoon doen in plaats van pas te handelen op het moment dat het relevant wordt?

Genoeg redenen om dit met het team te bespreken.