Checklist de operación

Usa esta lista antes de dar por buena una publicación.

Checklist editorial#

• la categoría tiene category.json
• todos los Markdown llevan front matter correcto
• no hay slugs duplicados dentro de la categoría
• las capturas están dentro de la carpeta del producto
• los títulos son legibles para usuario final

Checklist técnico#

• config.json apunta al content_root correcto
• base_path coincide con la URL real de publicación
• output_root es una carpeta segura de limpiar
• el build termina sin excepciones
• el search-index.json se ha generado

Checklist de UX#

• la home muestra la categoría nueva
• la búsqueda local no sale de su categoría
• el tema claro arranca por defecto dentro del sitio
• la pantalla de login se ve en modo nocturno
• el enlace de soporte va a la URL corporativa esperada

Diagnóstico rápido de errores frecuentes#

Error: no se encuentra content_root#

Revisa:

• ruta relativa en config.json
• estructura de checkout en pipeline
• permisos del agente sobre ambas carpetas

Error: slug duplicado#

Dos artículos de la misma categoría están generando la misma URL. Revisa slug o el nombre del fichero.

Error: categoría no coincide#

El valor category: del Markdown no coincide con el title o el slug de la categoría real.

Error: assets rotos#

Normalmente ocurre por:

• usar rutas absolutas de disco
• enlazar un fichero que no está dentro de la categoría
• haber movido un asset sin actualizar el Markdown

Validación recomendada antes de producción#

1. Ejecutar build local.
2. Servir output_root con un servidor estático.
3. Navegar al menos por una página de cada categoría.
4. Probar búsqueda global y búsqueda contextual.
5. Revisar login, soporte y enlaces externos.