Quando escreve um programa bem complexo, por vezes é útil adicionar comentários para simplificar uma posterior revisão do código. Aqui, por exemplo, é fácil se perder no processo de desenho e podeadicionar comentários como barra vertical desenhada ou terminei de desenhar o G. hora de voltar para posição inicial. Comentar o seu código é quase obrigatório se (ou mais alguém) quiser lê-lo depois, embora comentar demais (a descrever coisas óbvias) é ruim pois as ideias importantes se perdem no meio do ruído.
Existem [!java]três[/!][!python|scala|c]dois[/!] tipos de comentários em [!thelang], que instruem o [!java|scala|c]compilador[/!][!python]interpretador[/!] a não ler o texto que adiciona para humanos:
methodCallReadByThe[!java|scala|c]Compiler[/!][!python]Interpreter[/!]()[!java|c];[/!] [!java|scala|c]//[/!][!python]#[/!] tudo isto é ignorado otherCall()[!java|c];[/!] [!java|scala|c]/* Isto também é ignorado */[/!] [!python]''' Isto também é ignorado '''[/!] yetAnotherCall()[!java|c];[/!]
Existe um terceiro tipo de comentário em Java, entre /** e */, que é lido por um programa específico chamado JavaDoc para gerar automaticamente a documentação a explicar como usar o código. Estes comentários devem seguir um formalismo bem preciso.
Os comentários de várias linhas são frequentemente usados para documentar como usar o código, enquanto os outros são usados para descrever como este código funciona.