Jamdesk Documentation logo

Cómo Funciona Jamdesk

Git push a documentación publicada 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 queda disponible en un CDN global en menos de 60 segundos. Tu contenido permanece en tu repositorio como archivos planos. Nada propietario, nada 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 edge global. No gestionas ninguna infraestructura.

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

El Pipeline de Build

Típicamente de 30 a 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 localiza tu directorio de documentación.

2
Validación

Tu configuración docs.json se valida contra el esquema y los enlaces internos se comprueban para detectar páginas rotas y anchors incorrectos.

3
Procesamiento del Contenido

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

4
Despliegue al Edge

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

Incluido en Cada Sitio

Todo esto viene de serie con cada sitio. Nada que configurar.

Búsqueda con IA

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

llms.txt

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

Esenciales de SEO

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

Analítica Integrada

Un dashboard de analítica centrado en la privacidad sin cookies requeridas. O trae el tuyo propio: es compatible con 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 la 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 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 tu conexión con la GitHub App es de solo lectura.

Permisos Mínimos

La GitHub App solo solicita acceso de lectura a los repositorios que seleccionas. 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 edge y 99.9 % de uptime.

Rendimiento

Si tu documentación se encuentra o no depende en parte de la velocidad de carga. Google utiliza Core Web Vitals como señal de posicionamiento, y los rastreadores 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 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 la CLI de Jamdesk para hacer preview y validar tu documentación antes de hacer push