Saltar al contenido principal

Cómo agregar contenido

Guía para sumar o editar páginas del manual.

Estructura​

docs/
  docs/            ← páginas markdown (este sitio)
    intro.md       ← página de entrada
    avances/       ← estado por app / por bloque de trabajo
    flujos/        ← procesos end-to-end con diagramas
    wiki/          ← referencia técnica y how-tos
    manuales/      ← manuales de usuario
  static/diagrams/ ← HTML autocontenido generado con Archify
  src/components/  ← componentes React (DiagramEmbed)

Agregar una página​

  1. Creá el .md dentro de la categoría correspondiente (avances/, flujos/, wiki/, manuales/).
  2. Opcional: front matter con sidebar_label si el título es largo.
---
sidebar_label: Nombre corto
---

# Título de la página
  1. El sidebar se genera solo (autogenerated por carpeta). No hay que tocar sidebars.ts.

Agregar un diagrama (Archify)​

  1. Pedile al agente que genere el diagrama con la skill archify (está en .opencode/skills/archify/).
  2. El HTML resultante va a docs/static/diagrams/<nombre>.html (archivos autocontenidos, se versionan en git).
  3. Envolvelo en una página con el componente DiagramEmbed:
import DiagramEmbed from '@site/src/components/DiagramEmbed';

<DiagramEmbed
  src="diagrams/arquitectura.html"
  title="Arquitectura del sistema"
  height={640}
/>

Los archivos de static/ se sirven desde la raíz del sitio: src="diagrams/x.html" resuelve relativo a baseUrl.

Deploy​

Los cambios en docs/ deployan la app docs de CapRover (docs.garderie.ar):

pnpm deploy:docs

O con detección automática de cambios: pnpm deploy:changes (ver skill deploy-changes).