Primeros pasos

Orientarse en el workspace

La carpeta schoolsuite contiene varios repositorios Git independientes. Antes de ejecutar Git o modificar código:

find . -maxdepth 2 -type d -name .git -print
git -C kairos status --short
git -C docs status --short

Ejecuta cada comando desde el repositorio propietario. No asumas que el directorio padre comparte rama, historial o estado.

Trabajar en esta documentación

Con Node.js 20 o posterior:

cd docs
npm ci
npm run dev

Sin Node instalado en el host:

cd docs
docker run --rm -it -p 5173:5173 \
  -v "$PWD:/app" -w /app node:22-alpine \
  sh -c "apk add --no-cache git && npm ci && npm run dev -- --host 0.0.0.0"

Antes de abrir una merge request:

npm run check

Dónde documentar

Tipo de información	Ubicación
Marca, productos y narrativa pública	docs/site
Arquitectura y flujos entre repositorios	docs/site/platform
Implementación concreta de Kairos	kairos/docs o junto al código
Contrato interno de un servicio	README/docs del servicio
Despliegue compartido	platform/docs
Decisión transversal estable	Este portal, enlazando la evidencia propietaria