Opmerkingen zijn verklarende opmerkingen in de broncode van een programma die door de compiler of tolk worden genegeerd. Ze zijn uitsluitend bedoeld voor menselijke lezers om de code beter te begrijpen. Verschillende programmeertalen gebruiken verschillende syntaxis voor commentaar:

* Commentaar van één regel: Deze geven commentaar op een enkele regel code. Voorbeelden zijn onder meer:

* `// Dit is een commentaar van één regel in C++, Java, JavaScript en vele andere.`

* `# Dit is een commentaar van één regel in Python, Ruby en Bash.`

* Commentaar met meerdere regels (blokcommentaar): Deze geven commentaar op meerdere regels code. Voorbeelden zijn onder meer:

* `/* Dit is een commentaar van meerdere regels in C, C++, Java en andere.

Het kan meerdere regels omvatten. */`

* `''' Dit is een commentaar van meerdere regels in Python.

Het kan ook meerdere regels omvatten. '''`

* `""' Dit is een andere stijl van meerregelig commentaar in Python. """`

Het doel van opmerkingen is om:

* Leg het doel van de code uit: Beschrijf wat een functie, klasse of codeblok doet.

* Complexe logica verduidelijken: Breek ingewikkelde algoritmen of stappen op in kleinere, begrijpelijke delen.

* Documenteer aannames en beperkingen: Let op eventuele beperkingen of omstandigheden waaronder de code werkt.

* Geef context: Leg de redenering achter bepaalde ontwerpkeuzes uit.

* Laat opmerkingen achter voor toekomstige wijzigingen: Maak het voor anderen (of voor uzelf in de toekomst) gemakkelijker om de code te begrijpen en te onderhouden.

Goed geschreven commentaar is cruciaal voor de leesbaarheid, onderhoudbaarheid en samenwerking van code. Overmatig commentaar geven (commentaar geven op voor de hand liggende code) wordt over het algemeen afgeraden, omdat dit de code onoverzichtelijk kan maken en het moeilijker kan maken om te lezen. Het doel is om waarde toe te voegen aan het begrip van de code, en niet om te herhalen wat al duidelijk is.