Sección editorial¶
Esta sección documenta las reglas editoriales del apunte para que el criterio de publicación no dependa de memoria, costumbre o arrastre histórico.
Su objetivo es evitar tres problemas:
que cada capítulo se escriba con una estructura distinta,
que el tono y el formato se desalineen entre partes,
que aparezcan materiales publicados, planificados y vacíos mezclados sin criterio visible.
Alcance¶
Estas reglas aplican a:
capítulos de
parte_1aparte_4,futuras partes que se publiquen en el TOC principal,
índices, portadas y archivos de ejercicios integradores,
documentación editorial o de mantenimiento del propio sitio.
Documentos de esta sección¶
| Documento | Qué define |
|---|---|
| plantilla_capitulos | Estructura mínima obligatoria por tipo de página |
| estilo_y_formato | Voz, terminología, MyST, referencias, ejemplos y convenciones de escritura |
| infografias_svg | Reglas específicas para diagramas técnicos e infografías SVG |
| estado | Estados del contenido, criterios de publicación y checklist de mantenimiento |
| contribuciones | Canales y criterios para recibir aportes de terceros |
Regla corta¶
Antes de considerar “listo” un cambio editorial, debería cumplirse esto:
la página tiene la estructura mínima que le corresponde,
el índice de su parte y
myst.ymlcuentan la misma historia,el estado del contenido es explícito,
el tono, formato y referencias siguen las convenciones del sitio.
Qué se considera una página del apunte¶
No todas las páginas cumplen la misma función. A nivel editorial, el sitio hoy usa al menos estos tipos:
| Tipo de página | Ejemplos | Expectativa editorial |
|---|---|---|
| Capítulo regular | parte_1/04_metodos.md | Plantilla mínima completa |
| Índice o portada de parte | parte_2/indice.md | Mapa de aprendizaje + índice exhaustivo |
| Índice de familia o subtema | parte_4/creacionales/indice.md | Navegación, comparación y cierre integrador |
| Ejercicios integradores | parte_4/*/ejercicios_integradores.md | Consignas, no desarrollo teórico completo |
| Documentación editorial | editorial/*.md | Reglas de mantenimiento y publicación |
Uso esperado¶
La sección editorial sirve para dos momentos:
antes de escribir: elegir plantilla y alcance de la página,
antes de publicar: revisar que estructura, navegación y estado estén alineados.
Próximo paso¶
Si se va a crear o rehacer un capítulo, conviene seguir primero la plantilla mínima de capítulos.