Introducción

CoreDocs separa claramente el motor de generación y el contenido editorial:

• CoreDocs.Engine: genera el sitio, aplica estilos, autenticación, navegación, búsqueda y salida estática.
• CoreDocs.Tech: almacena el contenido de cada producto dentro de content/<categoria>/.

La idea de esta guía es que una persona pueda asumir cualquiera de estos tres roles sin depender de conocimiento tácito:

• autor de contenido
• responsable del motor
• responsable de pipeline y publicación

Qué resuelve la arquitectura actual#

• Cada web es una categoría independiente.
• Cada categoría define solo su metadata en category.json.
• Cada artículo .md define su propia posición en el sidebar mediante front matter.
• No hace falta mantener un structure.json con secciones y subsecciones.
• La búsqueda se comporta de forma distinta según el contexto:
• desde Inicio busca en todo el portal
• dentro de una categoría busca solo en esa categoría

Repositorios y responsabilidades#

Resultado del build#

El generador crea un portal estático con esta estructura base:

output_root/
  index.html
  search-index.json
  static/
  <categoria-1>/
    index.html
    <articulo>/index.html
  <categoria-2>/
    index.html

Por defecto output_root es dist/, pero ahora puede configurarse.

Qué encontrarás en esta categoría#

• cómo crear una nueva web de producto
• cómo redactar los .md con metadatos correctos
• cómo ejecutar el motor en local
• cómo configurar autenticación y publicación
• cómo plantear pipelines en Azure DevOps para CoreDocs.Tech

Recursos rápidos#

• Plantilla de configuración
• Plantilla de front matter
• Guía rápida de operación

Siguiente lectura#

Empieza por Arquitectura y funcionamiento y luego pasa a Autoría y contenido si vas a crear o revisar documentación.