Kommentare in Programmiersprachen dienen zum Annotieren von Code. Sie helfen anderen Programmierern dabei, sich schneller einen Überblick zu verschaffen.
Grundsätzlich gilt:
- Kommentare sagen nicht, was gemacht wird, sondern warum etwas gemacht wird.
- Kommentare sollten immer auf Englisch geschrieben werden.
- “So wenig wie möglich, so viel wie nötig.”
- Kommentare sollten verständlich und einfach gehalten werden.
- Der Code selbst sollte zur Dokumentation ausreichen.