Mantener la documentación
La documentación pública de Rapid OS usa Docusaurus como capa de presentación y mantiene el contenido Markdown canónico en docs/.
Estructura
docs/ # contenido canónico
website/
├── docusaurus.config.ts # configuración del sitio
├── sidebars.ts # arquitectura de navegación
├── src/css/custom.css # tema
└── package.json # dependencias y scripts
Docusaurus lee directamente ../docs, por lo que no debe crearse una segunda copia de los mismos documentos dentro de website/docs.
Regla de Product Truth
La documentación debe describir únicamente comportamiento verificable en el parser, dominio, tests o contratos del release.
Antes de documentar una capability nueva:
- confirmar que existe en código;
- confirmar comandos y flags reales;
- confirmar si el comando es read-only o state-writing;
- documentar archivos que crea o modifica;
- documentar exit codes y diagnósticos relevantes;
- diferenciar capacidad declarada, evidencia y veredicto;
- ejecutar el build de Docusaurus.
Desarrollo local
cd website
npm install
npm run start
Build de producción
cd website
npm install
npm run build
Los broken links deben tratarse como errores de build.