Comentarios

Seguramente puedes imaginar que el objetivo no es escribir programas que quepan en una postal. Con el tiempo, el código fuente de tus programas se volverá más extenso y complejo. En algún punto llega el momento en que el mero entrenamiento de la memoria ya no es suficiente para realizar un seguimiento de las cosas. Ahí es cuando entran al juego los comentarios.

Un comentario es un pequeño fragmento de texto que explica una determinada parte del código fuente para señalar problemas, tareas abiertas o cosas similares. El intérprete ignora un comentario, por lo que no cambia el flujo del programa.

La forma más sencilla de escribir un comentario es utilizar un comentario de línea. Este tipo de comentario comienza con el carácter # y termina al final de la línea:

# Un ejemplo con comentarios
print("Hola Mundo!") # Salida Hola Mundo simple

Para comentarios más largos, un comentario en bloque es una buena opción. Un comentario de bloque comienza y termina con tres comillas consecutivas:

""" Este es un comentario en bloque, 
puede extenderse a varias líneas. """

Los comentarios sólo deben utilizarse si contribuyen a la comprensión del código fuente o contienen información valiosa. Comentar cada línea, por poco importante que sea, lleva a que los árboles no dejen ver el bosque.