Como o Jamdesk funciona
Do git push à documentação publicada em menos de 60 segundos. Saiba como o Jamdesk cria, implanta e otimiza seu site sem infraestrutura para gerenciar.
O Jamdesk cria sites de documentação a partir de arquivos MDX no seu repositório do GitHub. Você escreve Markdown com componentes React, envia as alterações para o GitHub e seu site fica disponível em uma CDN global em menos de 60 segundos. Seu conteúdo permanece no repositório como arquivos MDX simples, permitindo migrá-lo para outra ferramenta a qualquer momento.
Visão geral da arquitetura
Seu repositório é a fonte principal. O Jamdesk se conecta a ele, cria seu site e faz a implantação em uma rede global de edge. Você não precisa gerenciar nenhuma infraestrutura.
O pipeline de build
Normalmente, leva de 30 a 60 segundos do início ao fim. Os builds são rápidos porque o Jamdesk não pré-renderiza as páginas. Seu conteúdo bruto vai para a edge, e as páginas são renderizadas sob demanda quando os visitantes as solicitam.
Você envia alterações para sua branch conectada do GitHub (ou seleciona Rebuild no dashboard). O Jamdesk clona seu repositório e encontra o diretório de documentação.
Sua configuração docs.json é validada de acordo com o schema, e os links internos são verificados para identificar páginas inexistentes e âncoras inválidas.
O Jamdesk gera, a partir do seu conteúdo, o índice de pesquisa, os embeddings do chat de IA, o sitemap, o arquivo llms.txt e as regras de redirecionamento.
O conteúdo é enviado para a CDN e se propaga para mais de 300 locais de edge. Apenas os arquivos alterados são transferidos, portanto as novas implantações são rápidas.
Incluído em todos os sites
Todos os sites incluem estes recursos por padrão. Nenhuma configuração é necessária.
O que aciona um build
Um git push para sua branch conectada, o botão Rebuild no dashboard ou jamdesk deploy pela CLI. Se você enviar vários commits em rápida sucessão, o Jamdesk os agrupa em um único build para evitar o consumo desnecessário de recursos.
Para obter detalhes operacionais (monitoramento de status, rollbacks, variáveis de ambiente e implantações de branch), consulte Ciclo de build e implantação.
Segurança e infraestrutura
Você não precisa se preocupar com esses detalhes, mas, se sua equipe de segurança perguntar: os builds são executados em contêineres isolados e a conexão com seu GitHub App é somente leitura.
Desempenho
A possibilidade de sua documentação ser encontrada depende, em parte, da velocidade de carregamento. O Google usa Core Web Vitals como sinal de classificação, e rastreadores de IA como GPTBot e ClaudeBot dedicam de 1 a 5 segundos a cada página. Se sua documentação não carregar nesse intervalo, ela não será citada.
Todos os sites Jamdesk são disponibilizados pela edge, com tempo até o primeiro byte inferior a 50 ms. Isso é rápido o suficiente para os limites de classificação do Google e para que os rastreadores de IA busquem e citem seu conteúdo.
| Métrica | Valor típico |
|---|---|
| Tempo de build | 30 a 60 segundos |
| Propagação da implantação | < 30 segundos |
| Primeiro byte (edge) | < 50 ms |
| Carregamento completo da página | < 500 ms |