Objetivo
Migrar todos los diagramas ASCII (\``text) en la documentación a Mermaid (```mermaid`), mejorando:
- Mantenibilidad: Diagramas declarativos, no píxeles
- Renderizado: Mejor visualización en GitHub/sitio
- Consistencia: Mismo formato en todo el repo
Scope
Convertir ~20 bloques de diagramas ASCII actualmente en:
docs/adr/anexos/001-i18n-router-framework/ARCHITECTURE_DIAGRAM.md (6+ diagramas)
docs/adr/anexos/001-i18n-router-framework/ARCHITECTURE_SECTIONS.md (2+ diagramas)
docs/adr/anexos/001-i18n-router-framework/MIGRATION_GUIDE.md (2+ diagramas)
docs/adr/anexos/001-i18n-router-framework/BEFORE_AFTER_COMPARISON.md (1+ diagramas)
docs/adr/002-testing-framework-migration.md (2+ diagramas)
docs/adr/003-third-party-mocks.md (2+ diagramas)
docs/adr/R03-migracion-gatsby-a-astro.md (2+ diagramas)
docs/adr/R02-migracion-jekyll-a-gatsby.md (1+ diagramas)
docs/adr/004-linting-any-ban-style-conventions.md (1+ diagramas)
Estrategia
- Por tipo de diagrama: Agrupar por tipo (flujo, arquitectura, comparación) y usar diagrama Mermaid apropiado
- Prioridad: Primero documentos activos/frecuentemente editados
- Validación: Verificar que lint pase y diagrama se renderice correctamente
Tipos Mermaid a usar
graph TD/LR — Flujos y dependencias
classDiagram — Estructuras de clases
sequenceDiagram — Interacciones en el tiempo
stateDiagram — Transiciones de estado
timeline — Migraciones/historial
Referencias
CONTENT_PAGE_OBJECTS_ARCHITECTURE.md — Ejemplo reciente de conversión exitosa
Objetivo
Migrar todos los diagramas ASCII (
\``text) en la documentación a Mermaid (```mermaid`), mejorando:Scope
Convertir ~20 bloques de diagramas ASCII actualmente en:
docs/adr/anexos/001-i18n-router-framework/ARCHITECTURE_DIAGRAM.md(6+ diagramas)docs/adr/anexos/001-i18n-router-framework/ARCHITECTURE_SECTIONS.md(2+ diagramas)docs/adr/anexos/001-i18n-router-framework/MIGRATION_GUIDE.md(2+ diagramas)docs/adr/anexos/001-i18n-router-framework/BEFORE_AFTER_COMPARISON.md(1+ diagramas)docs/adr/002-testing-framework-migration.md(2+ diagramas)docs/adr/003-third-party-mocks.md(2+ diagramas)docs/adr/R03-migracion-gatsby-a-astro.md(2+ diagramas)docs/adr/R02-migracion-jekyll-a-gatsby.md(1+ diagramas)docs/adr/004-linting-any-ban-style-conventions.md(1+ diagramas)Estrategia
Tipos Mermaid a usar
graph TD/LR— Flujos y dependenciasclassDiagram— Estructuras de clasessequenceDiagram— Interacciones en el tiempostateDiagram— Transiciones de estadotimeline— Migraciones/historialReferencias
CONTENT_PAGE_OBJECTS_ARCHITECTURE.md— Ejemplo reciente de conversión exitosa