Paradigma Docs-as-Code para cursos
La base es tratar el contenido como código: texto, assets, config y build evolucionan juntos con revisión y releases como flujos de primera clase.
cs249r_book trata un libro de curso como software entregable: capítulos en Markdown/Notebooks, builds reproducibles y cambios revisables para iteración en equipo. En vez de documentos dispersos, fija el contenido en un flujo Git y publica una experiencia de lectura estable mediante hosting estático como GitHub Pages. El valor real es mantenibilidad: actualizaciones, erratas y traducciones siguen el mismo ciclo de ingeniería y reducen la “podredumbre” del conocimiento.
| ✕Problemas Tradicionales | ✓Soluciones Innovadoras |
|---|---|
| Los materiales de curso suelen dispersarse entre editores/nubes/chats: caos de versiones, poca revisión y sin rollback, con alto coste de mantenimiento. | cs249r_book convierte el libro en repo: capítulos/assets/ejemplos comparten un flujo Git para revisión, comparación y regresión. |
| Sin pipeline de build+publicación, el contenido deriva en formato, rompe enlaces y ofrece una lectura inconsistente según plataforma. | Con Jupyter Book, build y tema se estandarizan, y la publicación estática vuelve “escribir→construir→publicar” automatizable. |
1git clone https://github.com/harvard-edge/cs249r_book.git && cd cs249r_book && python -m venv .venv1source .venv/bin/activate && pip install -U pip && pip install -r requirements.txt1jupyter-book build .1# Abrir _build/html/index.html o servirlo con un servidor estático local1# Con CI, publicar _build/html a una rama/pages o carpeta configurada| Escenario Principal | Público Objetivo | Solución | Resultado |
|---|---|---|---|
| Sitio de curso mantenible para docentes | docentes y ayudantes | colaborar en capítulos, tareas y erratas en un repo | cambios revisables, rollback seguro y releases estables |
| Apuntes versionados para formación interna | responsables de training | fijar apuntes, ejemplos y rutas de lectura en un sitio | cohortes trazables y consistencia más fuerte |
| Paquete offline para autoaprendizaje | autodidactas y grupos | clonar, construir y leer sin conexión | menos dependencia de plataformas y materiales duraderos |
