Flujo de contenido
La wiki de Wiedii no se edita directamente. Todo el contenido vive primero en el vault de Obsidian (wiedii-documentation) y llega a la wiki únicamente cuando ha sido auditado y marcado como listo.
Esto garantiza que lo que aparece en la wiki es contenido aprobado, no ideas a medio cocinar ni checklists personales.
El vault no es la wiki
El vault de Obsidian cumple dos roles distintos:
| Tipo de nota | Ejemplos | ¿Va a la wiki? |
|---|---|---|
| Documentación auditada | Políticas, guías, estándares | ✅ Sí |
| Ideas en progreso | Checklists, propuestas, borradores | ❌ No |
| Notas personales / meta | Plantillas, índices, kanban | ❌ No |
El campo estado en el frontmatter de cada nota es el gate que decide si una nota entra o no a la wiki.
Sistema de estados
Cada nota del vault tiene un campo estado en su frontmatter:
---
title: Mi documento
estado: borrador # ← este campo controla el flujo
---
Estados disponibles
| Estado | Significado | ¿El sync la toca? |
|---|---|---|
borrador | En progreso, no lista | Ignorada |
maduro | Auditada, lista para publicar | Se migra al wiki |
promovido | Ya está en la wiki | Verificada — si docs/ diverge del vault, se restaura |
Transiciones
borrador ──► (editas, revisas, auditas) ──► maduro
│
mise run sync
│
promovido
(vault = fuente de verdad)
│
┌────────────────────────────────┤
│ │
¿editaste el vault? ¿editaste docs/ directo?
script detecta el cambio el script lo detecta
y regresa a maduro ◄────── y restaura desde vault
para que la re-audites
Cómo agregar contenido nuevo a la wiki
1. Crea o edita la nota en Obsidian
Trabaja en el vault con normalidad. Usa el estado borrador mientras estás desarrollando el contenido.
---
title: Guía de X
estado: borrador
tags:
- herramienta
---
2. Audita el contenido
Antes de promover, revisa:
- El contenido es correcto y está completo
- No tiene ideas sin desarrollar ni TODOs visibles
- Los wikilinks apuntan a notas que existen
- El título y las etiquetas son adecuados
- No tiene notas personales mezcladas
3. Marca la nota como madura
Cuando el contenido esté listo, cambia el estado en el frontmatter:
estado: maduro
4. Ejecuta el sync
Desde el directorio del wiki:
# Previsualiza qué va a cambiar (sin tocar nada)
mise run sync:dry
# Ejecuta la migración real
mise run sync
El script se encarga del resto: convierte el formato, resuelve los wikilinks, actualiza el vault a promovido y mueve la tarjeta en el kanban.
Qué pasa si editas una nota ya promovida
Si editas una nota que ya está en la wiki (estado: promovido), el script detecta automáticamente el cambio en la siguiente ejecución y la regresa a estado: maduro.
Esto significa:
- Tu edición en Obsidian queda registrada
- La wiki no se actualiza automáticamente — primero debes re-auditar
- Cuando estés conforme, vuelves a poner
estado: maduroy corresmise run sync
Esto evita que cambios sin revisar lleguen a la wiki por accidente.
Campos de frontmatter relevantes
| Campo | Requerido | Descripción |
|---|---|---|
title | Sí | Título del documento |
estado | Sí | borrador / maduro / promovido |
tags | Recomendado | Etiquetas para clasificación |
destino | No | Referencia personal en Obsidian (no afecta el routing del sync — la carpeta física es la que determina la sección destino) |
wiki_slug | Opcional | Nombre de archivo personalizado en el wiki |
Uso de wiki_slug
Por defecto el nombre del archivo en el wiki es el nombre de la nota en minúsculas. Si necesitas un nombre diferente:
wiki_slug: nombre-personalizado
Esto produce docs/<sección>/nombre-personalizado.md.
Kanban de estados
El archivo kanban-estados-vault.md en la raíz del vault es un tablero visual de qué notas están en qué estado. El script lo actualiza automáticamente al promover notas.
Puedes usarlo como dashboard para saber qué está pendiente de auditar.