docs: mejorar documentación de lecciones de fundamentos

- Agregar docstrings completos en español a todas las lecciones de fundamentos
- Incluir comentarios explicativos detallados para cada ejemplo
- Agregar ejemplos de salida esperada para mejor comprensión
- Incluir ejercicios prácticos y experimentos adicionales
- Agregar enlaces a recursos oficiales de Python
- Mejorar nombres de variables para mayor claridad
- Actualizar fechas a 2025-07-12

Lecciones mejoradas:
- 01_prints.py: Función print() y strings básicos
- 02_variables.py: Variables y tipos de datos
- 03_input_data.py: Entrada de datos del usuario
- 04_type_conversion.py: Conversión de tipos
- 05_strings.py: Manipulación de strings
- 06_formatted_strings.py: Formateo de strings
- 07_functions_methods.py: Funciones y métodos

Mejoras incluidas:
- Documentación teórica completa
- Ejemplos prácticos con salidas esperadas
- Ejercicios adicionales para práctica
- Conceptos importantes resumidos
- Variaciones y experimentos opcionales

Author: jacs4210

lecciones/fundamentos/01_prints.py

@@ -1,4 +1,78 @@
+"""
+Lección 01: Función print() y Strings Básicos
+
+Descripción:
+Esta lección introduce la función print(), que es la forma más básica de mostrar
+información en la consola de Python. También aprenderás sobre strings (cadenas de texto)
+y cómo crear patrones simples.
+
+Objetivos:
+- Comprender cómo usar la función print()
+- Aprender sobre strings y comillas
+- Crear patrones simples con caracteres
+- Entender la multiplicación de strings
+
+Conceptos Clave:
+- print(): Función para mostrar texto en consola
+- String: Tipo de dato para texto
+- Comillas simples (') y dobles (")
+- Operador de multiplicación (*) con strings
+
+Recursos Adicionales:
+- Documentación oficial: https://docs.python.org/3/library/functions.html#print
+- Tutorial de strings: https://docs.python.org/3/tutorial/introduction.html#strings
+
+Autor: Jairo Cuartas
+Fecha: 2025-07-12
+"""
+
+# =============================================================================
+# EJEMPLO 1: Función print() básica
+# =============================================================================
 print("Jairo Cuartas")
+# Salida esperada: Jairo Cuartas
+
+# =============================================================================
+# EJEMPLO 2: Creando patrones con strings
+# =============================================================================
 print('o------')
+# Salida esperada: o------
+
 print('  ||||')
-print('>' *  10)
+# Salida esperada:   ||||
+# Nota: Los espacios al inicio son parte del string
+
+# =============================================================================
+# EJEMPLO 3: Multiplicación de strings
+# =============================================================================
+print('>' * 10)
+# Salida esperada: >>>>>>>>>>
+# Nota: El operador * repite el string 10 veces
+
+# =============================================================================
+# EJERCICIOS PRÁCTICOS
+# =============================================================================
+# Intenta crear estos patrones:
+# 1. Una línea de asteriscos (*) de 15 caracteres
+# 2. Un patrón de puntos (...) de 8 caracteres
+# 3. Tu nombre en mayúsculas
+
+# =============================================================================
+# CONCEPTOS IMPORTANTES
+# =============================================================================
+"""
+1. print() es una función que muestra texto en la consola
+2. Los strings pueden usar comillas simples (') o dobles (")
+3. El operador * puede multiplicar strings
+4. Los espacios en blanco son parte del string
+5. Cada print() crea una nueva línea automáticamente
+"""
+
+# =============================================================================
+# VARIACIONES Y EXPERIMENTOS
+# =============================================================================
+# Descomenta estas líneas para experimentar:
+
+# print("Hola" + " " + "Mundo")  # Concatenación de strings
+# print("Python" * 3)            # Multiplicación
+# print("Línea 1\nLínea 2")      # Caracteres especiales

lecciones/fundamentos/02_variables.py

@@ -1,8 +1,111 @@
-price = 10
-# Es posible sobreesccribir un valor usando la misma variable, por ejemplo.
-price = 15
-porcentage = 3.4
-name = "Jairo Cuartas"
-is_exists = True
-is_false = False
+"""
+Lección 02: Variables y Tipos de Datos Básicos
+
+Descripción:
+Esta lección introduce el concepto de variables en Python. Las variables son contenedores
+que almacenan datos en la memoria. Aprenderás sobre diferentes tipos de datos básicos
+y cómo asignar valores a variables.
+
+Objetivos:
+- Comprender qué son las variables
+- Conocer los tipos de datos básicos en Python
+- Aprender a asignar valores a variables
+- Entender la sobreescritura de variables
+
+Conceptos Clave:
+- Variable: Contenedor para almacenar datos
+- Asignación: Proceso de guardar un valor en una variable
+- Tipos de datos: int, float, str, bool
+- Sobrescritura: Cambiar el valor de una variable existente
+
+Recursos Adicionales:
+- Documentación oficial: https://docs.python.org/3/tutorial/introduction.html#variables
+- Tipos de datos: https://docs.python.org/3/library/stdtypes.html
+
+Autor: Jairo Cuartas
+Fecha: 2025-07-12
+"""
+
+# =============================================================================
+# EJEMPLO 1: Variables numéricas (int - números enteros)
+# =============================================================================
+precio = 10
+print(f"Precio inicial: {precio}")
+# Salida esperada: Precio inicial: 10
+
+# Es posible sobreescribir un valor usando la misma variable
+precio = 15
+print(f"Precio actualizado: {precio}")
+# Salida esperada: Precio actualizado: 15
+
+# =============================================================================
+# EJEMPLO 2: Variables de punto flotante (float - números decimales)
+# =============================================================================
+porcentaje = 3.4
+print(f"Porcentaje: {porcentaje}%")
+# Salida esperada: Porcentaje: 3.4%
+
+# =============================================================================
+# EJEMPLO 3: Variables de texto (str - strings)
+# =============================================================================
+nombre = "Jairo Cuartas"
+print(f"Nombre: {nombre}")
+# Salida esperada: Nombre: Jairo Cuartas
+
+# =============================================================================
+# EJEMPLO 4: Variables booleanas (bool - valores lógicos)
+# =============================================================================
+existe = True
+es_falso = False
+print(f"¿Existe?: {existe}")
+print(f"¿Es falso?: {es_falso}")
+# Salida esperada: 
+# ¿Existe?: True
+# ¿Es falso?: False
+
+# =============================================================================
+# VERIFICACIÓN DE TIPOS DE DATOS
+# =============================================================================
+print(f"\nTipos de datos:")
+print(f"precio ({precio}): {type(precio)}")
+print(f"porcentaje ({porcentaje}): {type(porcentaje)}")
+print(f"nombre ({nombre}): {type(nombre)}")
+print(f"existe ({existe}): {type(existe)}")
+
+# =============================================================================
+# EJERCICIOS PRÁCTICOS
+# =============================================================================
+# Intenta crear estas variables:
+# 1. Una variable 'edad' con tu edad
+# 2. Una variable 'altura' con tu altura en metros
+# 3. Una variable 'ciudad' con tu ciudad
+# 4. Una variable 'estudiante' con True o False
+
+# =============================================================================
+# CONCEPTOS IMPORTANTES
+# =============================================================================
+"""
+1. Las variables son contenedores que almacenan datos
+2. Python infiere automáticamente el tipo de dato
+3. Puedes cambiar el valor de una variable (sobrescribir)
+4. Los nombres de variables deben ser descriptivos
+5. Python es sensible a mayúsculas y minúsculas
+"""
+
+# =============================================================================
+# VARIACIONES Y EXPERIMENTOS
+# =============================================================================
+# Descomenta estas líneas para experimentar:
+
+# # Variables con nombres más descriptivos
+# edad_usuario = 25
+# temperatura_ambiente = 22.5
+# nombre_completo = "María García"
+# es_activo = True
+
+# # Verificar tipos
+# print(f"Tipo de edad_usuario: {type(edad_usuario)}")
+# print(f"Tipo de temperatura_ambiente: {type(temperatura_ambiente)}")
+# print(f"Tipo de nombre_completo: {type(nombre_completo)}")
+# print(f"Tipo de es_activo: {type(es_activo)}")
 

lecciones/fundamentos/03_input_data.py

@@ -1,4 +1,101 @@
-name = input("Cual es tu nombre? ")
-last_name = input ("Cual es tu primer apellido? ")
+"""
+Lección 03: Entrada de Datos del Usuario - Función input()
 
-print("Bienvenido " + name + " " + last_name)
+Descripción:
+Esta lección introduce la función input(), que permite al programa recibir datos
+directamente del usuario a través del teclado. Es fundamental para crear programas
+interactivos que respondan a la entrada del usuario.
+
+Objetivos:
+- Comprender cómo usar la función input()
+- Aprender a capturar datos del usuario
+- Entender que input() siempre devuelve un string
+- Crear programas interactivos básicos
+
+Conceptos Clave:
+- input(): Función para recibir datos del usuario
+- Prompt: Mensaje que se muestra al usuario
+- String: input() siempre devuelve texto
+- Interactividad: El programa espera respuesta del usuario
+
+Recursos Adicionales:
+- Documentación oficial: https://docs.python.org/3/library/functions.html#input
+- Tutorial de entrada/salida: https://docs.python.org/3/tutorial/inputoutput.html
+
+Autor: Jairo Cuartas
+Fecha: 2025-07-12
+"""
+
+# =============================================================================
+# EJEMPLO 1: Captura básica de datos del usuario
+# =============================================================================
+nombre = input("¿Cuál es tu nombre? ")
+# El programa se pausa aquí y espera que el usuario escriba algo
+# Cuando el usuario presiona Enter, el valor se guarda en 'nombre'
+
+apellido = input("¿Cuál es tu primer apellido? ")
+# Nuevamente, el programa espera la entrada del usuario
+
+# =============================================================================
+# EJEMPLO 2: Mostrar los datos capturados
+# =============================================================================
+print("Bienvenido " + nombre + " " + apellido)
+# Salida esperada: Bienvenido [nombre] [apellido]
+# Ejemplo: Si el usuario ingresa "Juan" y "Pérez"
+# Salida: Bienvenido Juan Pérez
+
+# =============================================================================
+# EJEMPLO 3: Usando f-strings para mejor formato
+# =============================================================================
+print(f"¡Hola {nombre} {apellido}! Es un placer conocerte.")
+# Salida esperada: ¡Hola [nombre] [apellido]! Es un placer conocerte.
+
+# =============================================================================
+# EJEMPLO 4: Verificando el tipo de dato
+# =============================================================================
+print(f"\nInformación sobre los datos ingresados:")
+print(f"Nombre: '{nombre}' (tipo: {type(nombre)})")
+print(f"Apellido: '{apellido}' (tipo: {type(apellido)})")
+# Salida esperada:
+# Información sobre los datos ingresados:
+# Nombre: '[nombre]' (tipo: <class 'str'>)
+# Apellido: '[apellido]' (tipo: <class 'str'>)
+
+# =============================================================================
+# EJERCICIOS PRÁCTICOS
+# =============================================================================
+# Intenta crear estos programas:
+# 1. Preguntar la edad y mostrar "Tienes X años"
+# 2. Preguntar la ciudad y mostrar "Vives en X"
+# 3. Preguntar nombre y edad, luego mostrar "Te llamas X y tienes Y años"
+
+# =============================================================================
+# CONCEPTOS IMPORTANTES
+# =============================================================================
+"""
+1. input() siempre devuelve un string, sin importar qué escriba el usuario
+2. El programa se pausa hasta que el usuario presiona Enter
+3. El prompt (mensaje) es opcional pero muy útil
+4. Puedes usar variables para almacenar la entrada del usuario
+5. input() es fundamental para programas interactivos
+"""
+
+# =============================================================================
+# VARIACIONES Y EXPERIMENTOS
+# =============================================================================
+# Descomenta estas líneas para experimentar:
+
+# # Captura de diferentes tipos de información
+# edad = input("¿Cuál es tu edad? ")
+# ciudad = input("¿En qué ciudad vives? ")
+# profesion = input("¿Cuál es tu profesión? ")
+
+# # Mostrar toda la información recopilada
+# print(f"\nResumen de tu información:")
+# print(f"Nombre: {nombre} {apellido}")
+# print(f"Edad: {edad} años")
+# print(f"Ciudad: {ciudad}")
+# print(f"Profesión: {profesion}")
+
+# # Nota: Aunque el usuario ingrese números, input() los trata como texto
+# print(f"Tipo de edad: {type(edad)}")  # Siempre será <class 'str'>