Comentarios

En JavaScript, los comentarios son una forma de agregar explicaciones al código que se ignora al ejecutar el programa.

Los comentarios son útiles para explicar el por qué del código, documentar los cambios realizados en el código y hacer que el código sea más fácil de entender para otros desarrolladores.

Hay dos tipos de comentarios en JavaScript: los comentarios de una sola línea y los comentarios de varias líneas.

Comentarios de una sola línea //

Los comentarios de una sola línea comienzan con // y se utilizan para agregar una explicación en una sola línea de código. Por ejemplo:

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

// Iniciamos el radio por 10, pero puede cambiar
let radio = 10

También puedes añadir un comentario de una sola línea al final de una línea de código. Por ejemplo:

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

Comentarios de varias líneas /* */

Los comentarios de varias líneas comienzan con /_ y terminan con _/. Se utilizan para agregar notas explicativas que ocupan varias líneas de código. Por ejemplo:

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

Ten en cuenta que también puedes lograr varias líneas usando el tipo de comentario //, sólo que en este caso, cada línea de código debe comenzar con //. Por ejemplo:

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

Es importante tener en cuenta que los comentarios no afectan el funcionamiento del código. Es decir, si se eliminan los comentarios, el código seguirá funcionando de la misma manera.

Es recomendable utilizar comentarios con moderación y de manera efectiva para hacer que el código sea más fácil de entender y mantener. Los comentarios deben ser claros y concisos, y deben explicar lo que hace el código sin repetir lo que ya es obvio.

Es mejor que tu código sea lo suficientemente claro como para no necesitar comentarios, pero si es necesario, utiliza comentarios para explicar el por qué del código, no el qué.