sources/
Copias literales de documentos técnicos externos que una página de content/ cita
como su fuente de detalle, pero que nunca se transcriben a la prosa de la wiki.
Existe para el material demasiado técnico, extenso o específico de una herramienta
(cierres de query SQL, roadmaps de columnas, bitácoras de descarte de hipótesis con
datos) para reescribirse en el estilo de convenciones.md sin perder precisión — pero
que sigue siendo relevante como respaldo consultable.
Diferencia con raw/
raw/ es una zona de staging previo a compilar: todo lo que entra ahí tiene como
destino final convertirse en una página de content/ (o descartarse explícitamente)
vía /wiki-ingest. sources/ es lo opuesto — el documento ya fue revisado, ya
generó o amplió la página de content/ correspondiente, y se copia aquí tal cual
para quedarse indefinidamente como referencia de detalle. Nunca pasa de sources/
a content/ reescrito — si hiciera falta más prosa de wiki, la página de content/
ya cubre lo que vale la pena tener ahí; lo que queda en sources/ es el detalle
exacto que esa página resume.
raw/ | sources/ | |
|---|---|---|
| Estado | Pendiente de compilar | Ya usado, no se va a transcribir más |
| Se edita después de agregarlo | No (inmutable; re-ingesta si la fuente cambia) | No (copia literal) |
Frontmatter de convenciones.md | No | No |
| Aparece en el grafo de Quartz | No | Sí, vía symlink content/sources -> ../sources (desde que se dio de baja Mintlify) |
Cómo se referencia desde content/ | Indirectamente, vía la página que generó | Directamente, por ruta, como respaldo técnico |
Que sources/ aparezca en el grafo de Quartz es solo alcance de build (el symlink deja que Quartz lo encuentre y genere sus páginas de carpeta) — no cambia ninguna otra fila de la tabla: sigue sin frontmatter, sigue siendo copia inmutable, y sigue sin reescribirse a content/.
Reglas
- Copia byte a byte del original, sin editar ni una palabra — ni siquiera para corregir un typo del original. Si el original cambia, se reemplaza la copia entera (no un parche) y se anota en el índice del subdirectorio.
- No lleva frontmatter de
convenciones.md(nada deproject/host/tags/status) — no es una página de la wiki, es un anexo. - Se organiza en subcarpetas por proyecto, reflejando la misma jerarquía que
content/(ej.sources/trivasa/layout-gastos/). Cada subcarpeta lleva unREADME.mdcorto que liste cada archivo con su origen (repo + ruta original), la fecha en que se copió y una línea de qué contiene — ese contexto vive en el índice, nunca dentro del archivo copiado. - Se referencia desde la página de
content/correspondiente por ruta literal entre backticks (ej.`sources/trivasa/layout-gastos/v3_0_cxp_completo_cierre.md`) — no como wikilink, porque Quartz no construye nada fuera decontent/; el enlace no sería clicable en el sitio publicado.
Cuándo usar sources/ en vez de transcribir a content/
Cuando el documento es la fuente de detalle técnico (SQL completo, tablas de
validación exhaustivas, bitácora de qué hipótesis se descartó y por qué) que respalda
una afirmación ya resumida en una página de content/: la página de la wiki cuenta el
“qué y por qué” en prosa consultable; sources/ guarda el “cómo, exacto, con todos los
números” para cuando haga falta auditar el detalle sin reconstruirlo desde cero.
Véase también: content/meta/convenciones.md — reglas de content/, que sources/
deliberadamente no sigue. content/meta/claude-code-workflow.md — dónde encaja
sources/ en la estructura del repo.