Fuente
- Todo el sitio vive en `docs-site/`.
- No depende del build de Svelte del panel principal.
- Se publica como HTML/CSS estatico.
Mantenimiento
Como mantener y desplegar esta documentacion
La docs vive como sitio estatico separado de `web-admin` para publicarse de forma rapida, repetible y sin arrastrar el build completo del panel principal.
Arquitectura
Topologia de despliegue
Destinos
- Vercel: proyecto `docs-site`.
- Hostinger: website `docs.kapture.cloud`.
- Ambos sirven exactamente los mismos archivos estaticos.
Por que esta separado
Separar la docs evita mezclar deuda o warnings del panel con el publish del portal de documentacion y hace trivial replicarlo entre Vercel y Hostinger.
Edicion
Archivos que normalmente se tocan
| Archivo | Rol |
|---|---|
docs-site/index.html |
Portada y mapa general del portal. |
docs-site/quickstart/index.html |
Onboarding tecnico y configuracion minima. |
docs-site/architecture/index.html |
Modelo del backend, triggers y compatibilidad. |
docs-site/webhooks/index.html |
Contrato HTTP, schemas y firma. |
docs-site/integrations/index.html |
Playbook de patrones por destino. |
docs-site/troubleshooting/index.html |
Diagnostico operativo y casos comunes. |
docs-site/styles.css |
Sistema visual compartido del portal. |
Revision
Revisar localmente antes de publicar
cd docs-site
python3 -m http.server 4173
Que revisar
Navegacion lateral, enlaces cruzados, tablas responsivas, bloques de codigo y que no haya rastro de copy viejo o rutas muertas.
Publicacion 1
Deploy en Vercel
cd docs-site
npx vercel deploy --prod --yes
Proyecto enlazado
El directorio `docs-site/` ya esta enlazado al proyecto Vercel `docs-site` mediante `.vercel/project.json`.
Publicacion 2
Deploy en Hostinger
cd /ruta/al/repositorio
zip -rq /tmp/docs-site_YYYYMMDD_HHMMSS.zip docs-site
Luego
El ZIP generado se publica como static website sobre `docs.kapture.cloud`. El sitio debe contener solo archivos listos para servir: HTML, CSS, JS e imagenes si existieran.
Verificacion
Checklist final despues del deploy
curl -I https://docs.kapture.cloud
curl -I https://docs.kapture.cloud/webhooks/
curl -I https://docs.kapture.cloud/integrations/
curl -I https://docs-site-psi-lac.vercel.app
Esperado
Respuesta `HTTP 200` en Hostinger y en el mirror de Vercel.
Si algo no cuadra
Revisar primero cache, luego links rotos y finalmente si el ZIP o el deploy salieron del directorio correcto.