Volver
Año
Agosto 2025 - Actualidad
Tecnologías
MkDocs, Python, Markdown, GitHub Actions, Open Source
Descripción
Decisiones y por qué. Opté por una arquitectura JAMstack utilizando MkDocs y Markdown en lugar de un CMS tradicional con base de datos. Esto me garantizó costo cero de infraestructura (alojado en GitHub Pages), tiempos de carga casi instantáneos y máxima portabilidad del contenido en archivos de texto plano. Estructuré el repositorio de forma modular por materias y planes de estudio. Para asegurar la escalabilidad sin mantenimiento manual, implementé un pipeline de CI/CD con GitHub Actions: cada vez que se aprueba un Pull Request con nuevo material, un bot automatiza la compilación del sitio, valida la estructura y despliega los cambios en producción de forma transparente.
Una decisión de la que estoy orgulloso. No exigirle Git a nadie. El instinto de todo desarrollador es forzar el "camino correcto" (fork, branch, PR), pero eso hubiera dejado afuera al 90% de los que tenían material valioso para compartir. Bajar la barrera de entrada a un mensaje de WhatsApp convirtió a estudiantes no técnicos en contribuidores de un proyecto open source sin que lo supieran.
Resultados. 22 materias con apuntes, prácticos y parciales resueltos, ~7.800 vistas y 474 visitantes únicos por quincena, 416 clones en 14 días, 63 stars, 486 commits y tráfico orgánico desde Google. El contenido más visitado es la carpeta de Materias: la gente entra directo a estudiar, que era el objetivo.
Una decisión de la que estoy orgulloso. No exigirle Git a nadie. El instinto de todo desarrollador es forzar el "camino correcto" (fork, branch, PR), pero eso hubiera dejado afuera al 90% de los que tenían material valioso para compartir. Bajar la barrera de entrada a un mensaje de WhatsApp convirtió a estudiantes no técnicos en contribuidores de un proyecto open source sin que lo supieran.
Resultados. 22 materias con apuntes, prácticos y parciales resueltos, ~7.800 vistas y 474 visitantes únicos por quincena, 416 clones en 14 días, 63 stars, 486 commits y tráfico orgánico desde Google. El contenido más visitado es la carpeta de Materias: la gente entra directo a estudiar, que era el objetivo.