Foire aux questions

Jamdesk est une plateforme de documentation qui génère des sites de docs à partir de vos fichiers Markdown. Rédigez en MDX, poussez sur GitHub, et votre site se déploie automatiquement avec recherche, analytique et llms.txt prêt pour l'IA.

Aucune compétence en développement n'est requise. Écrire en MDX ressemble à utiliser un éditeur de texte : vous rédigez du texte brut avec une mise en forme simple. Les composants sont disponibles si vous le souhaitez, mais ils sont entièrement facultatifs.

Oui ! Nous proposons un essai gratuit de 14 jours avec accès complet à toutes les fonctionnalités.

Jamdesk est construit autour de MDX et GitHub : vos docs sont des fichiers texte brut dans un dépôt, non enfermés dans un éditeur propriétaire. Poussez sur GitHub et votre site se déploie en moins de 60 secondes, sans configuration de build ni pipeline CI/CD. Chaque site obtient automatiquement llms.txt et un serveur MCP, afin que les outils IA comme Claude et ChatGPT puissent accéder directement à vos docs actuelles. Les visiteurs bénéficient également d'un assistant de chat IA intégré qui répond aux questions à partir de vos docs.

La plupart des sites de documentation se construisent en 30 à 60 secondes. Les sites plus volumineux avec de nombreuses pages peuvent prendre plus longtemps.

Oui ! Utilisez le CLI Jamdesk (jamdesk dev) pour prévisualiser localement avec rechargement à chaud. Les modifications ne sont mises en ligne que lorsque vous poussez sur GitHub ou exécutez jamdesk deploy.

Oui. Exécutez jamdesk deploy depuis le répertoire de votre projet. Le CLI conditionne vos fichiers, les téléverse et déclenche un build directement. Aucun dépôt Git n'est requis. Consultez le guide CLI Deploy pour plus de détails.

Les builds se déclenchent automatiquement lorsque vous poussez vers votre branche GitHub connectée. Vous pouvez également déclencher des builds manuellement depuis le dashboard ou avec jamdesk deploy via le CLI.

Oui. Accédez à Déploiements dans votre projet, trouvez le build précédent et cliquez sur Rollback.

Le plan Pro est à 29 $/mois par projet. Les projets supplémentaires sont à 15 $/mois chacun. Consultez Plans et tarifs pour plus de détails.

Nous proposons un essai gratuit de 14 jours. Après cela, un abonnement Pro est nécessaire pour continuer.

Nous acceptons les cartes de crédit Visa, Mastercard, American Express et Discover.

Nous proposons des remboursements dans les 30 jours suivant votre premier paiement. Contactez le support pour obtenir de l'aide.

Oui ! Ajoutez un domaine personnalisé dans Paramètres → Domaines. Les certificats SSL sont provisionnés automatiquement.

Les modifications DNS se propagent généralement en quelques heures, mais peuvent prendre jusqu'à 48 heures.

Oui. Utilisez un reverse proxy (Cloudflare, AWS, nginx) pour servir Jamdesk sur un sous-chemin. Consultez Hébergement sur sous-chemin.

Ouvrez votre projet, allez dans Paramètres → Membres, saisissez l'adresse e-mail de la personne dans le champ Inviter un membre et cliquez sur Inviter. Elle recevra un e-mail avec un lien pour rejoindre le projet.

Les utilisateurs invités ont besoin d'un compte Jamdesk ; s'ils n'en ont pas, ils sont invités à en créer un lors de l'acceptation. Déjà membre, mais le lien d'invitation indique qu'il a « déjà été accepté » ? Vous n'avez pas besoin d'une nouvelle invitation. Connectez-vous simplement et vous serez redirigé vers le projet. Consultez Membres de l'équipe pour les rôles et les limites de membres.

Les plans Pro incluent 10 membres d'équipe par projet.

Les membres de l'équipe peuvent consulter les builds et déclencher des reconstructions, mais la modification s'effectue dans votre dépôt GitHub. Toute personne ayant accès au dépôt peut modifier les docs.

Accédez à Paramètres → Membres, puis cliquez sur Transférer la propriété à côté du membre que vous souhaitez promouvoir. Le nouveau propriétaire doit être un membre existant de l'équipe.

Dans ~/.jamdeskrc, un fichier JSON avec des permissions 0600 (seul votre utilisateur peut le lire). Il contient votre jeton de rafraîchissement, votre email et votre identifiant utilisateur. Exécutez jamdesk logout pour le supprimer.

Votre jeton de rafraîchissement n'est plus valide. Cela se produit après des changements de mot de passe, des suppressions de compte ou une inactivité prolongée. Exécutez jamdesk login pour obtenir une nouvelle session.

Oui, mais la connexion via navigateur ne fonctionnera pas dans les environnements sans interface graphique. Connectez-vous sur votre machine locale, puis copiez ~/.jamdeskrc vers votre runner CI. Le jeton de rafraîchissement gère l'authentification à partir de là.

Jamdesk prend en charge MDX (Markdown + JSX) et les fichiers Markdown standard.

Oui. Définissez des composants inline directement dans MDX avec export const, ou créez des composants réutilisables dans le répertoire /snippets. Pour les composants interactifs avec des hooks, utilisez des fichiers .tsx avec 'use client'. Consultez Composants React personnalisés et Snippets.

Aucune limite stricte sur le nombre de pages. La plupart des sites de documentation fonctionnent bien avec des centaines de pages.

Oui. Utilisez la propriété languages dans votre configuration de navigation pour créer un sélecteur de langue. Chaque langue dispose de sa propre structure de navigation et de son propre contenu. Consultez Support multilingue.

Non. Jamdesk ne traduit pas le contenu à votre place. Vous fournissez les fichiers MDX traduits et Jamdesk gère le routage, la navigation, le sélecteur de langue et le style RTL. Apportez les traductions de votre propre workflow (traducteurs humains, traduction automatique ou un LLM) et placez-les dans des répertoires préfixés par la langue (es/, fr/, etc.). Consultez Support multilingue pour la structure des répertoires et la configuration.

Oui. Chaque site Jamdesk inclut un assistant de chat intégré qui répond aux questions des visiteurs à partir de votre documentation. Il est activé par défaut, aucune configuration n'est requise. Consultez Chat IA pour plus de détails.

Non. Le chat IA est inclus dans tous les plans sans coût supplémentaire.

Oui. Définissez chat.enabled à false dans votre docs.json :

{ "chat": { "enabled": false } }

Le panneau de chat et le raccourci clavier seront supprimés après votre prochain build.

Le chat utilise uniquement vos pages de documentation publiées. À chaque build, Jamdesk indexe votre contenu dans une base de données vectorielle. Lorsqu'un visiteur pose une question, les sections pertinentes sont récupérées et envoyées à Claude comme contexte. L'IA ne peut pas accéder à des données extérieures à vos docs.

Oui. Marquez les pages internes avec private: true dans le frontmatter, ou listez leurs chemins sous auth.password.private[] dans docs.json. Les pages publiques restent publiques ; les pages privées affichent un écran de déverrouillage. Un seul projet, un seul dépôt, un seul build. Consultez Contrôle d'accès et Protection par mot de passe.

Définissez auth.password.enabled: true dans docs.json, poussez la modification, puis définissez un mot de passe dans Paramètres du projet → Protection par mot de passe dans le dashboard. Chaque visiteur voit un écran de déverrouillage jusqu'à ce qu'il le saisisse. Consultez Protection par mot de passe.

Oui, sur les plans Enterprise. L'authentification unique (SSO) permet aux lecteurs de s'authentifier auprès de votre fournisseur d'identité (Okta, Google Workspace, Azure AD, etc.) sans mots de passe partagés, avec un journal d'audit complet et une révocation instantanée des accès. Consultez SSO ou contactez les ventes Enterprise.

En général, non. Un seul projet avec private: true sur les pages internes est plus simple : même dépôt, même build, un seul dashboard. Utilisez deux projets uniquement lorsque les audiences nécessitent un branding entièrement distinct, des domaines personnalisés ou des analytiques séparées. Consultez Contrôle d'accès pour les modèles disponibles.

Les éditeurs rédigent les docs en soumettant du MDX dans votre dépôt GitHub connecté : toute personne ayant un accès en écriture à votre branche de documentation peut publier une modification. Les lecteurs consultent le site publié : tout le monde (public), toute personne disposant du mot de passe (mode mot de passe), ou toute personne connectée via votre fournisseur d'identité (SSO). Les membres de l'équipe du dashboard sont un concept distinct : ils gèrent les builds et les analytiques, mais ne rédigent pas de contenu directement. Consultez Contrôle d'accès.