Plantilla de lección¶

Copia este archivo por cada materia/lección nueva y renómbralo (ej. docs/capa-0-cimientos/estructuras-de-datos.md). Esta plantilla es para lecciones extensas para leer. Para una síntesis breve de un concepto ya cerrado, usa la plantilla de nota.

{Título de la lección}¶

De un vistazo

Materia: {Capa X · nombre} · Tiempo de lectura: ~{N} min · Requisitos previos: {lecciones que hay que traer sabidas}

En una frase: {qué vas a entender al terminar}.

Por qué esto importa¶

Engancha antes de teorizar. El dolor concreto, el fenómeno que el lector ya ha sufrido sin saber por qué. Responde: ¿qué problema resuelve entender esto?

Intuición primero¶

La imagen mental antes que la definición formal. Una analogía que sostenga el resto de la lección. Si hace falta, un diagrama.

graph LR
  A[idea] --> B[imagen mental]

El detalle¶

La mecánica de verdad, por partes. Aquí va el grueso: subsecciones, ejemplos de código, diagramas, tablas comparativas. No tener miedo a extenderse — es una lección para leer, no un resumen.

{Subsección}¶

Texto explicado. Ejemplos concretos.

Cómo se ve en la práctica¶

Un ejemplo real (empresa, proyecto, código conocido). Que el lector vea el concepto vivo, no en abstracto.

Lo que sacrificas / errores comunes¶

Todo diseño paga un precio. Las trampas típicas y los malentendidos frecuentes.

Resumen¶

Los 3–5 puntos que deben quedar. Si el lector solo recuerda esto, va servido.

Ejercicios socráticos¶

No busques la respuesta fuera. Razónala. Si te atascas, la pista está en el propio texto.

{Pregunta que obligue a razonar, no a reconocer.}
{…}

Repaso espaciado¶

Pasa estas a Anki (repasos.md). Formato: pregunta que obligue a razonar.

[ ] {Tarjeta 1}
[ ] {Tarjeta 2}

Para seguir tirando del hilo¶

{Libro, charla, paper o código para profundizar.}