Cómo funciona Jamdesk
Git push a documentación en vivo en menos de 60 segundos. Descubre cómo Jamdesk crea, despliega y optimiza tu sitio de documentación.
Jamdesk crea sitios de documentación a partir de archivos MDX en tu repositorio de GitHub. Escribes Markdown con componentes de React, haces push a GitHub, y tu sitio está en vivo en una CDN global en menos de 60 segundos. Tu contenido permanece en tu repositorio como archivos MDX planos, por lo que puedes moverlo a otra herramienta en cualquier momento.
Descripción general de la arquitectura
Tu repositorio es la fuente de verdad. Jamdesk se conecta a él, crea tu sitio y lo despliega en una red edge global. No necesitas gestionar ninguna infraestructura.
El pipeline de build
Normalmente 30-60 segundos, de principio a fin. Los builds son rápidos porque Jamdesk no pre-renderiza las páginas. Tu contenido en bruto va al edge, y las páginas se renderizan bajo demanda cuando los visitantes las solicitan.
Haces push a tu rama de GitHub conectada (o pulsas Rebuild en el dashboard). Jamdesk clona tu repositorio y encuentra tu directorio de documentación.
Tu configuración docs.json se valida contra el schema, y los enlaces internos se revisan en busca de páginas rotas y anclas incorrectas.
Jamdesk genera tu índice de búsqueda, embeddings de chat con IA, sitemap, llms.txt y reglas de redirección a partir de tu contenido.
El contenido se sube a la CDN y comienza a desplegarse en más de 300 ubicaciones edge. Solo se transfieren los archivos modificados, por lo que los redespliegues son rápidos.
Integrado en cada sitio
Cada sitio incluye estas funciones por defecto. No se requiere configuración.
Qué desencadena un build
Un git push a tu rama conectada, el botón Rebuild en el dashboard, o jamdesk deploy desde el CLI. Si haces push de varios commits en rápida sucesión, Jamdesk los agrupa en un solo build para no desperdiciar recursos.
Para detalles operativos (monitoreo de estado, rollbacks, variables de entorno, despliegues de ramas), consulta Ciclo de vida de build y despliegue.
Seguridad e infraestructura
No necesitas pensar en esto, pero si tu equipo de seguridad pregunta: los builds se ejecutan en contenedores aislados y tu conexión de la GitHub App es de solo lectura.
Rendimiento
Que tu documentación se encuentre depende en parte de la velocidad con la que carga. Google usa Core Web Vitals como señal de posicionamiento, y los crawlers de IA como GPTBot y ClaudeBot se conceden entre 1 y 5 segundos por página. Si tu documentación no carga en esa ventana, no se cita.
Todo sitio Jamdesk se despliega desde el edge con un tiempo hasta el primer byte inferior a 50 ms. Eso es lo suficientemente rápido para los umbrales de posicionamiento de Google y para que los crawlers de IA la obtengan y la citen.
| Métrica | Valor típico |
|---|---|
| Tiempo de build | 30-60 segundos |
| Propagación del despliegue | < 30 segundos |
| Primer byte (edge) | < 50ms |
| Carga completa de página | < 500ms |