Skip to content

docs: aclarar qué aporta cada fuente al currículo - #3

Merged
vladimiracunadev-create merged 6 commits into
mainfrom
docs/sources-explainer
May 17, 2026
Merged

docs: aclarar qué aporta cada fuente al currículo#3
vladimiracunadev-create merged 6 commits into
mainfrom
docs/sources-explainer

Conversation

@vladimiracunadev-create

Copy link
Copy Markdown
Owner

Problema

El README y syllabus decían 'pauta derivada de Géron, VanderPlas, Huyen, ISLP y Barocas/Hardt/Narayanan' — frase que no le decía nada concreto a un lector externo (¿qué libros?, ¿qué aportan?, ¿por qué esos cinco?).

Cambios

  • README.md — bloque desplegado con un bullet por autor enlazando al libro y diciendo qué parte cubre cada uno.
  • docs/syllabus.md — nueva sección ## 📚 Fuentes y pauta con tabla completa (autor, edición, editorial, aporte concreto al temario) y nota explicando qué significa derivado (secuencia y énfasis, no copia de contenido).

🤖 Generated with Claude Code

vladimiracunadev-create and others added 6 commits May 17, 2026 18:58
… 9 partes)

Remueve referencias a v1, currículo anterior, "31 clases", "13 módulos" e
historicos/ de la documentación activa. La fuente de verdad del producto es
la carpeta classes/ con 197 clases en 9 partes.

- README, ROADMAP, RECRUITER, CONTRIBUTING, SECURITY: estado neutro sin v1/v2
- docs/syllabus, INDEX, GUIA_EVALUACION, cronograma, ARQUITECTURA, CATALOGO:
  filas y secciones sobre v1 archivado eliminadas
- docs/student-guide, instructor-guide, metodologia, plan-evaluacion,
  perfil-estudiantes, portal-estudiante, herramientas, aula-ia,
  entorno-interactivo: banner "v1 → v2" removido
- datasets/README: mapeo dataset→clase v1 reemplazado por descripción
- classes/README, mobile/README: títulos y notas sin sufijo v2

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- Hero centrado con tagline y dos grupos de badges (estado + tech stack)
- Tabla de estado del producto con iconos por aspecto
- Mapa visual de las 9 partes del currículo (clases por parte)
- Diagrama Mermaid de dependencias entre partes con colores
- Iconos en todas las secciones, tablas y bullets
- Bloque qué es / qué no es en dos columnas (HTML table)
- Footer con badges sociales

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Aplicación consistente del estándar visual establecido para README:
- Hero centrado con badges para documentos de alto nivel (RECRUITER,
  ROADMAP, SECURITY, RUNBOOK, CHANGELOG, CONTRIBUTING, INDEX,
  GUIA_EVALUACION, CATALOGO_PRODUCTO, ARQUITECTURA_PRODUCTO, syllabus,
  cronograma)
- Iconos en cabeceras H2/H3 y celdas de tablas a lo largo de los 25 docs
- Pase automático en docs pedagógicos (student-guide, instructor-guide,
  metodologia-docente, plan-evaluacion, perfil-estudiantes,
  portal-estudiante, herramientas-pedagogicas, aula-ia, entorno-interactivo,
  despliegue-seguro-y-operacion, BUILD_INSTALLER, MOBILE_APP, MIGRACION_AWS)
  con emojis contextuales por palabra clave del título

Sin cambios de contenido — sólo refinamiento visual.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
# Conflicts:
#	CONTRIBUTING.md
#	README.md
#	RECRUITER.md
#	ROADMAP.md
#	SECURITY.md
#	docs/CATALOGO_PRODUCTO.md
#	docs/INDEX.md
#	docs/aula-ia-y-problemas-frecuentes.md
#	docs/cronograma-referencial.md
#	docs/perfil-estudiantes.md
#	docs/syllabus.md
Se elimina la frase opaca 'pauta derivada de Géron, VanderPlas, Huyen, ISLP y
Barocas/Hardt/Narayanan' (que no decía nada concreto al lector) y se reemplaza por:

- README.md: bloque desplegado con un bullet por autor enlazando al libro y
  diciendo qué parte del currículo cubre cada uno.
- docs/syllabus.md § Fuentes y pauta: tabla completa con autor, edición,
  editorial y aporte concreto al temario, más una nota explicando qué significa
  'derivado' (secuencia y énfasis, no copia de contenido).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@vladimiracunadev-create
vladimiracunadev-create merged commit 9640a3c into main May 17, 2026
4 checks passed
@vladimiracunadev-create
vladimiracunadev-create deleted the docs/sources-explainer branch May 19, 2026 01:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant