Comentarios

El código que hoy te parece clarísimo, dentro de unos meses te costará entenderlo. Los comentarios son la solución: explicaciones que añades al código y que JavaScript ignora al ejecutar el programa. No son para la computadora, son para las personas.

Sirven para explicar el porqué del código, documentar los cambios que se han hecho y ponérselo más fácil a otros desarrolladores.

Ya los has visto en acción: son esos // que acompañan a los ejemplos del curso. En realidad hay dos tipos de comentarios en JavaScript: los de una sola línea y los de varias líneas.

Comentarios de una sola línea //#

Empiezan con // y todo lo que venga detrás, hasta el final de la línea, es comentario. Lo habitual es ponerlos justo encima del código que explican:

// Sólo usamos 6 decimalesconst PI = 3.141592// Iniciamos el radio por 10, pero puede cambiarlet radio = 10

Si la explicación es corta, también puedes añadirla al final de una línea de código:

const PI = 3.141592 // Sólo usamos 6 decimales

Comentarios de varias líneas /* */#

¿Tienes mucho que contar? Los comentarios de varias líneas comienzan con /* y terminan con */. Todo lo que quede en medio se ignora, ocupe las líneas que ocupe:

/*  Este es un comentario de varias líneas.  Se utiliza para agregar notas explicativas que  ocupan varias líneas de código.*/

Puedes lograr lo mismo con //, solo que entonces cada línea debe comenzar con //:

// Este es un comentario de varias líneas.// Se utiliza para agregar notas explicativas// que ocupan varias líneas de código.

Uses el tipo que uses, los comentarios no afectan al funcionamiento del código. Si los eliminas todos, el programa seguirá funcionando exactamente igual.

Eso no significa que haya que comentarlo todo. Úsalos con moderación: un buen comentario es claro, conciso y no repite lo que ya es obvio.

// Guardamos 10 en radiolet radio = 10

// Puede cambiar más adelantelet radio = 10