Jamdesk Documentation logo

Cómo funciona Jamdesk

Git push a documentación en vivo en menos de 60 segundos. Aprende cómo Jamdesk construye, despliega y optimiza tu sitio de documentación sin infraestructura que gestionar.

Jamdesk construye sitios de documentación a partir de archivos MDX en tu repositorio de GitHub. Escribes Markdown con componentes React, haces push a GitHub, y tu sitio está en vivo en un CDN global en menos de 60 segundos. Tu contenido permanece en tu repositorio como archivos planos. Nada propietario, nada de lo que migrar.

Descripción general de la arquitectura

Tu repositorio es la fuente de verdad. Jamdesk se conecta a él, construye tu sitio y lo despliega en una red global de edge. No gestionas ninguna infraestructura.

Cómo fluye el contenido desde tu repositorio hasta tus usuarios

El pipeline de build

Normalmente 30–60 segundos, de principio a fin. Los builds son rápidos porque Jamdesk no pre-renderiza páginas. Tu contenido sin procesar va al edge, y las páginas se renderizan bajo demanda cuando los visitantes las solicitan.

1
Obtención del código fuente

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.

2
Validación

Tu configuración docs.json se valida contra el esquema, y los enlaces internos se comprueban en busca de páginas rotas y anclas incorrectas.

3
Procesamiento de contenido

Jamdesk genera tu índice de búsqueda, embeddings del chat de IA, el sitemap, llms.txt y las reglas de redirección a partir de tu contenido.

4
Desplegar al edge

El contenido se sube al CDN y se propaga a más de 300 ubicaciones de edge. Solo se transfieren los archivos modificados, por lo que los redespliegues son rápidos.

Incluido en cada sitio

Todo esto viene gratis con cada sitio. Sin nada que configurar.

Búsqueda con IA

Búsqueda en lenguaje natural que entiende la intención, no solo palabras clave. Impulsada por embeddings vectoriales generados a partir de tu contenido durante el build.

llms.txt

Índice legible por IA siguiendo la especificación de llmstxt.org. Los asistentes de programación y los agentes de IA pueden consumir tu documentación directamente.

SEO esencial

Sitemap, robots.txt, imágenes Open Graph y metaetiquetas. Tu documentación es indexable desde el primer despliegue.

Analítica integrada

dashboard de analítica centrado en la privacidad sin necesidad de cookies. O trae el tuyo propio: admite Google Analytics, Plausible, PostHog y más.

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 único build para no malgastar recursos.

Para detalles operativos (monitoreo de estado, reversiones, variables de entorno, despliegues por rama), consulta Ciclo de vida de build y despliegue.

Seguridad e infraestructura

No necesitas preocuparte por esto, pero si tu equipo de seguridad pregunta: los builds se ejecutan en contenedores aislados y la conexión de tu GitHub App es de solo lectura.

Permisos mínimos

La GitHub App solo solicita acceso de lectura a los repositorios que selecciones. Sin acceso de escritura, sin permisos a nivel de organización.

Builds aislados

Cada build obtiene su propio contenedor que se destruye tras el despliegue. Nada persiste entre builds ni entre clientes.

HTTPS en todas partes

Certificados SSL automáticos para dominios personalizados y subdominios. Sin gestión manual de certificados.

CDN global

Servido desde la red de Cloudflare con más de 300 ubicaciones de edge y un 99.9% de tiempo de actividad.

Rendimiento

Que tu documentación sea encontrada depende en parte de lo rápido que cargue. Google usa Core Web Vitals como señal de clasificación, y los rastreadores de IA como GPTBot y ClaudeBot se dan 1–5 segundos por página. Si tu documentación no carga en ese tiempo, no será citada.

Cada sitio Jamdesk se sirve desde el edge con un tiempo hasta el primer byte inferior a 50 ms. Suficientemente rápido para Google, suficientemente rápido para que los rastreadores de IA lo citen.

MétricaValor típico
Tiempo de build30-60 segundos
Propagación del despliegue< 30 segundos
Primer byte (edge)< 50ms
Carga completa de página< 500ms

Próximos pasos

Crear un proyecto

Configura un nuevo sitio de documentación en el dashboard

Conectar GitHub

Vincula tu repositorio para habilitar los builds automáticos

Preview local

Usa el CLI de Jamdesk para hacer preview y validar tu documentación antes de hacer push