Comentarios

---

¿Qué es un comentario?

Un comentario es una línea o bloque de texto dentro del código que no se ejecuta.

Su función principal es explicar el código para que tú (o cualquier otra persona) pueda entenderlo fácilmente en el futuro.

---

¿Para qué sirven los comentarios?

• Para explicar qué hace una parte del código.
• Para recordar por qué se tomó cierta decisión en la programación.
• Para desactivar temporalmente alguna línea de código (comentándola) sin eliminarla.
• Para mejorar la legibilidad y mantenimiento de proyectos grandes.

Los comentarios son señal de buenas prácticas de programación.

---

Tipos de Comentarios en Python:

1. Comentarios de Una Sola Línea:

Se escriben usando el símbolo #. Todo lo que siga después del # será ignorado por Python.

# Este es un comentario de una sola línea
nombre = "Juan"  # También puedo comentar al final de una línea de código

2. Comentarios de Varias Líneas:

Se escriben usando tres comillas simples (''') o tres comillas dobles (""") al principio y al final. Esto permite escribir explicaciones largas que ocupen varias líneas.

Ejemplo usando comillas simples:

'''
Este es un comentario
de varias líneas
explicando el código
'''
print("Hola mundo")

Ejemplo usando comillas dobles:

"""
También puedo usar
tres comillas dobles
para comentarios largos
"""
print("Bienvenido")

---

Buenas prácticas para comentar código:

• No comentes lo obvio. (Ejemplo: a = 5 # asigna 5 a a → No es necesario).
• Usa comentarios claros y concisos.
• Mantén actualizado el comentario si cambias el código.
• Sé profesional y respetuoso en los comentarios (nada de bromas internas o lenguaje inadecuado).
• Usa el mismo idioma en todo tu código (si programas en español, comenta en español).

---