Contexto
Hoy el contenido de Glosario y Definiciones vive como HTML inline dentro de `R/panels_metadata.R` (~180 líneas, mayormente texto y `tags$p`/`tags$ul`). El comentario en el archivo ya anticipa esto:
Si crece el contenido, evaluar moverlo a archivos .qmd/.md y cargarlos con `includeMarkdown()`.
El contenido ya es extenso (especialmente la sección "Intervención INDEC 2007-2015" y "Limitaciones del panel") y va a seguir creciendo a medida que sumemos análisis (pobreza, filtros sociodemográficos, etc.).
Objetivo
Extraer el contenido a archivos separados, mantenibles sin tocar R:
- `R/contenido_metadata/glosario_intro.md`
- `R/contenido_metadata/definiciones.md` (o quizás varios: `definiciones_panel.md`, `definiciones_intervencion_indec.md`, `definiciones_limitaciones.md`)
- `R/panels_metadata.R` se reduce a la lógica de carga (`shiny::includeMarkdown()` o `htmltools::HTML(rmarkdown::render(...))`) + el `gt` de la tabla del Glosario.
Beneficios
- El contenido lo puede editar cualquiera (incluso sin saber R) abriendo el .md.
- El diff de un cambio de redacción no se mezcla con cambios de UI.
- Permite incorporar formato Markdown más cómodo (listas anidadas, citas, code blocks) sin pelear con `tags$$`.
- Habilita en el futuro reutilizar fragmentos en blog/Quarto.
Decisiones a tomar
- Formato: ¿`.md` plano o `.qmd` con eventuales chunks de R? Para texto puro, `.md` con `shiny::includeMarkdown()` alcanza.
- Granularidad: ¿un solo archivo por nav_panel, o partir en subsecciones (más fácil de editar)?
- Renderizado: `includeMarkdown()` lee del filesystem en cada sesión (overhead chico). Alternativa: pre-renderizar a HTML en build time si hay performance issue (no creo).
- Glosario: la tabla sigue como `tibble` + `gt` en R porque es estructurada. Solo la intro y la nota se mueven a md.
Criterios de aceptación
Prioridad
Baja. Funcionalidad cero, mejora de mantenibilidad. Hacer cuando se planee sumar bastante contenido más (por ejemplo al cerrar #29 o #30).
Contexto
Hoy el contenido de Glosario y Definiciones vive como HTML inline dentro de `R/panels_metadata.R` (~180 líneas, mayormente texto y `tags$p`/`tags$ul`). El comentario en el archivo ya anticipa esto:
El contenido ya es extenso (especialmente la sección "Intervención INDEC 2007-2015" y "Limitaciones del panel") y va a seguir creciendo a medida que sumemos análisis (pobreza, filtros sociodemográficos, etc.).
Objetivo
Extraer el contenido a archivos separados, mantenibles sin tocar R:
Beneficios
Decisiones a tomar
Criterios de aceptación
Prioridad
Baja. Funcionalidad cero, mejora de mantenibilidad. Hacer cuando se planee sumar bastante contenido más (por ejemplo al cerrar #29 o #30).