2.10. Los comentarios

Conforme los programas van creciendo de tamaño y complicándose, se vuelven mas complicados de leer. Los lenguajes formales son densos y con frecuencia es difícil observar un trozo de código y averiguar lo que hace, o por que lo hace.

Por ello es una buena idea a~nadir notas a su programa que expliquen, en un lenguaje natural, que hace el programa. Estas notas se llaman comentarios y se marcan con el símbolo #:

   1: # calcula el porcentaje de la hora que ha pasado ya porcentaje = (minuto * 100) / 60

En este caso, el comentario aparece en una línea propia. También puede poner comentarios al final de otras líneas:

   1: porcentaje = (minuto * 100) / 60 # ojo: división de enteros

Todo lo que va del # al final de la línea se ignora (no tiene efecto sobre el programa). El mensaje esta destinado al programador, o a futuros programadores que podrían tener que usar el código. En este caso avisa al lector sobre el sorprendente comportamiento de la división de enteros.