Metodología, versiones y fuentes
Qué decisiones pedagógicas y técnicas hay detrás del contenido, qué se comprueba antes de publicar y cómo se gestiona una actualización.
1. Una dificultad nueva cada vez
La secuencia intenta minimizar carga accidental: antes de una abstracción aparece el problema que resuelve; antes de pedir producción independiente hay ejemplos y práctica guiada; después el apoyo se retira y el concepto reaparece combinado con otros.
- Modelo mental: qué representa la herramienta y qué cambia en el programa.
- Ejemplo trabajado: código pequeño donde la idea nueva es visible.
- Predicción: anticipar antes de ejecutar.
- Práctica guiada: una decisión concreta con feedback.
- Transferencia: problema parecido con menos pistas.
- Recuperación acumulativa: conceptos anteriores vuelven a aparecer para evitar aprendizaje aislado.
2. Qué se comprueba antes de publicar
Revisión técnica
- Ejemplos ejecutables cuando el fragmento debe poder copiarse.
- Salidas esperadas coherentes con la solución.
- Prácticas iniciales que no se bloquean ni vienen resueltas.
- Enlaces internos, títulos, metadescripciones y estructura HTML auditados.
Revisión pedagógica
- Una habilidad observable por actividad.
- Errores frecuentes ligados al concepto real.
- Pistas que reducen dificultad sin revelar inmediatamente la respuesta.
- Separación entre núcleo para principiantes y detalles para después.
3. Matriz de versiones
| Componente | Referencia | Estado en esta revisión |
|---|---|---|
| CPython | Python 3 moderno | El 2026-09-30, Python 3.14.7 era la versión estable más reciente publicada. El contenido evita depender de novedades innecesarias cuando una sintaxis más común enseña mejor el concepto. |
| Editor web | Pyodide 0.29.5 | Runtime fijado basado en Python 3.13 para que una actualización externa no cambie ejercicios sin revisión. |
| Navegador | WebAssembly + Web Worker + JavaScript moderno | El editor requiere un navegador con soporte de WebAssembly y Worker. Cada ejecución usa un namespace limpio y las ejecuciones demasiado largas pueden interrumpirse reiniciando el worker. |
La versión estable de CPython puede avanzar más rápido que el runtime web. Eso no se oculta: cuando una diferencia de versión afecte a una lección, debe señalarse en esa página.
4. Jerarquía de fuentes
- Documentación oficial de Python: referencia principal para comportamiento del lenguaje y biblioteca estándar.
- PEP: para diseño, evolución y convenciones como PEP 8.
- Documentación de Pyodide: para capacidades y limitaciones del editor web.
- Fuentes secundarias: solo cuando ayudan a contextualizar una práctica o una decisión pedagógica, sin sustituir la fuente primaria para hechos técnicos.
5. Actualizaciones, automatización y responsabilidad editorial
Los cambios sustanciales deben registrarse en Correcciones. Una actualización de versión no justifica cambiar contenido automáticamente: primero se comprueba si modifica sintaxis, comportamiento o recomendación.
Se pueden usar herramientas de automatización para comprobar estructura, enlaces, duplicaciones o ejecutar ejemplos. Estas herramientas ayudan a detectar problemas, pero no sustituyen la decisión editorial sobre qué explicar, qué eliminar o qué necesita un principiante.