Quand vous écrivez un programme un peu complexe, il est souvent pratique d'ajouter des commentaires pour simplifier la relecture du code après coup. Ici par exemple, il est assez facile de se perdre dans les ordres nécessaires au dessin. Il peut être pratique d'ajouter des commentaires comme fin de la barre verticale ou Fini de dessiner le G. Retournons à la position initiale. Documenter votre code est presque toujours nécessaire si quelqu'un (vous ou quelqu'un d'autre) veut le lire après coup. Cependant, sur-commenter des choses triviales est une mauvaise idée car cela dilue les informations dans des commentaires trop verbeux.
Il y a [!java]trois[/!][!python|scala|c]deux[/!] sortes de commentaires en [!thelang], indiquant [!java|scala|c]au compilateur[/!][!python]à l'interpréteur[/!] qu'il ne doit pas lire le texte ajouté pour les humains.
methodeAppeleeParLe[!java|scala|c]Compilateur[/!][!python]Interpreteur[/!]()[!java|c];[/!] [!java|scala|c]//[/!][!python]#[/!] tout ceci est ignoré autreAppel()[!java|c];[/!] [!java|scala|c]/* Ceci est également ignoré */[/!] [!python]''' Ceci est également ignoré '''[/!] encoreUneAutreAppel()[!java|c];[/!]
Il existe une troisième forme de commentaires en Java, entre /** et */, qui sont lus par un programme nommé JavaDoc pour générer automatiquement la documentation expliquant comment utiliser le code. Ces commentaires doivent suivre un formalisme précis.
Les commentaires sur plusieurs lignes sont souvent utilisés pour documenter comment utiliser le code, tandis que les autres types de commentaires sont souvent utilisés pour documenter comment le code fonctionne.