Commentaar is tekst die je tussen je code schrijft en die de computer volledig negeert. Het verandert niets aan wat je programma doet; het is er enkel voor de mensen die de code lezen — je medeleerlingen, je leerkracht, en niet in het minst jezelf binnen een paar weken.
Goede commentaar maakt je code begrijpelijker en helpt je om fouten sneller terug te vinden.
Alles na // tot het einde van de regel is commentaar:
// Dit is commentaar en wordt niet uitgevoerd
Console.WriteLine("Hallo!"); // commentaar mag ook achter een instructie
Voor een langer stuk uitleg begin je met /* en eindig je met */. Alles
daartussen is commentaar, ook al loopt het over meerdere regels:
/*
Dit programma toont een begroeting.
Geschreven als eerste voorbeeld.
*/
Console.WriteLine("Hallo!");
Een handige bijkomende truc: door // voor een regel code te zetten, schakel je
die regel tijdelijk uit zonder ze te verwijderen. Zo kan je iets uitproberen en
het later makkelijk terugzetten:
Console.WriteLine("Deze regel werkt.");
// Console.WriteLine("Deze regel staat even uit.");
Goede commentaar legt uit waarom je iets doet, niet letterlijk wat er staat.
// tel 1 op bij tellervoegt weinig toe;// ga naar de volgende deelnemeris veel nuttiger.