Commentaar in je code
Toen ik de applicatie van de NS aan het controleren was met Numega DevPartner begon deze applicatie te klagen over ontbrekend commentaar in de code. Dit verbaasde me nogal, tot dat ik het volgende constateerde.
Volgens Numega is het volgende niet voorzien van commentaar:
private string testje()
{
/* Dit is commentaar */
return “Dit slaat nergens op“;
}
En dit wel:
private string testje()
{
// Dit is commentaar
return “Dit slaat nergens op“;
}
Op zich zijn beide opties natuurlijk voorzien van commentaar. Numega vindt echter dat je dus de // moet gebruiken voor in-source commentaar. De /* */ commentaar markers stammen nog uit de oude C wereld. Ze zitten er alleen in om die oude C hackers een plezier te doen.
Ik pas het dus nu aan waar ik het tegenkom. Benieuwd naar jullie reacties.