Comment fonctionne Jamdesk
Publiez vos docs en moins de 60 secondes. Découvrez comment Jamdesk build, déploie et optimise votre site de documentation sans infrastructure à gérer.
Jamdesk génère des sites de documentation à partir de fichiers MDX dans votre dépôt GitHub. Vous écrivez du Markdown avec des composants React, vous poussez vers GitHub, et votre site est en ligne sur un CDN mondial en moins de 60 secondes. Votre contenu reste dans votre dépôt sous forme de fichiers ordinaires. Rien de propriétaire, rien à migrer.
Présentation de l'architecture
Votre dépôt est la source de vérité. Jamdesk s'y connecte, génère votre site et le déploie sur un réseau edge mondial. Vous ne gérez aucune infrastructure.
Le pipeline de build
En général 30 à 60 secondes, du début à la fin. Les builds sont rapides car Jamdesk ne pré-rend pas les pages. Votre contenu brut est envoyé à l'edge, et les pages se rendent à la demande lorsque les visiteurs les consultent.
Vous poussez vers votre branche GitHub connectée (ou cliquez sur Reconstruire dans le dashboard). Jamdesk clone votre dépôt et localise votre répertoire de documentation.
Votre configuration docs.json est validée par rapport au schéma, et les liens internes sont vérifiés pour détecter les pages manquantes et les ancres incorrectes.
Le contenu est téléversé sur le CDN et se propage vers 300+ emplacements edge. Seuls les fichiers modifiés sont transférés, ce qui accélère les redéploiements.
Intégré à chaque site
Tout cela est inclus gratuitement avec chaque site. Rien à configurer.
Ce qui déclenche un build
Un git push vers votre branche connectée, le bouton Reconstruire dans le dashboard, ou jamdesk deploy depuis le CLI. Si vous poussez plusieurs commits en succession rapide, Jamdesk les regroupe en un seul build pour ne pas gaspiller de ressources.
Pour les détails opérationnels (surveillance du statut, retours en arrière, variables d'environnement, déploiements par branche), consultez Cycle de vie du build et du déploiement.
Sécurité et infrastructure
Vous n'avez pas à vous soucier de tout cela, mais si votre équipe sécurité le demande : les builds s'exécutent dans des conteneurs isolés et votre connexion GitHub App est en lecture seule.
Performance
La visibilité de votre documentation dépend en partie de sa vitesse de chargement. Google utilise les Core Web Vitals comme signal de classement, et les crawlers IA comme GPTBot et ClaudeBot s'accordent 1 à 5 secondes par page. Si votre documentation ne se charge pas dans cette fenêtre, elle ne sera pas citée.
Chaque site Jamdesk est servi depuis l'edge avec un temps jusqu'au premier octet inférieur à 50 ms. Suffisamment rapide pour Google, suffisamment rapide pour être cité par les crawlers IA.
| Métrique | Valeur typique |
|---|---|
| Durée du build | 30-60 secondes |
| Propagation du déploiement | < 30 secondes |
| Premier octet (edge) | < 50ms |
| Chargement complet de la page | < 500ms |