Connectez-vous à Ferndesk en tant que propriétaire ou administrateur, dans l’espace de travail où vous avez commencé la connexion. Si vous avez changé d’espace de travail dans un autre onglet, revenez à celui-ci et réessayez de vous connecter.
Connecter GitHub
Connectez GitHub pour que Fern puisse lire votre code et les demandes de fusion fusionnées. Fern s’en sert pour rédiger des articles exacts, préparer des mises à jour lorsque vous déployez et actualiser les références d’API lorsque le code change. Fern ne fait que lire votre code.
Les propriétaires et les administrateurs peuvent connecter GitHub et choisir les dépôts utilisés par Fern.
Installer l’application Ferndesk
Commencez dans Intégrations, puis installez l’application Ferndesk sur GitHub et choisissez les dépôts auxquels elle peut accéder. Une seule installation peut couvrir un produit réparti sur plusieurs dépôts, par exemple un serveur et un tableau de bord.
Si vous ne pouvez pas installer d’applications dans votre organisation GitHub, GitHub envoie une demande d’installation à ses propriétaires. Une fois la demande approuvée, choisissez de nouveau Connecter pour terminer. Si vous vous connectez sans installer l’application, Fern ne peut pas préparer de brouillons à partir des demandes de fusion fusionnées.
Vous utilisez plusieurs espaces de travail Ferndesk avec une seule installation GitHub ? Choisissez Réutiliser une connexion GitHub au lieu d’autoriser une nouvelle connexion. Vous devez être propriétaire ou administrateur de l’espace de travail d’où provient la connexion. Ses dépôts sont désactivés par défaut dans le nouvel espace de travail.
Choisir les dépôts utilisés par Fern
Chaque dépôt partagé par l’installation comporte une option permettant de définir si Fern l’utilise pour la documentation. Les nouveaux dépôts sont activés par défaut.
Désactiver un dépôt l’exclut des recherches de code et des brouillons de demandes de fusion de Fern dans cet espace de travail. L’application GitHub peut toujours y accéder.
Pour partager plus ou moins de dépôts, choisissez Modifier les dépôts sur GitHub dans le menu de la connexion.
Avec Support, Fern lit tous les dépôts partagés lorsqu’il consulte la conversation d’un client, quel que soit l’état de l’option.
Définir la branche de production
La branche de production est celle qu’utilisent vos clients. Une demande de fusion est considérée comme déployée lorsqu’elle y est fusionnée ; c’est ce qui déclenche la création de brouillons à partir des demandes de fusion fusionnées. Chaque dépôt utilise sa branche par défaut jusqu’à ce que vous en choisissiez une autre dans la colonne Branche de production. Si cette branche n’existe plus sur GitHub, le dépôt passe en haut de la liste avec une note. Si la branche a été supprimée, Fern revient à la branche par défaut. Si elle a été renommée, choisissez son nouveau nom dans Branche de production.
Dépannage
La connexion échoue avec une erreur de connexion ou d’espace de travail
La connexion échoue avec une erreur d’accès après l’autorisation
Le compte GitHub que vous avez utilisé ne peut pas accéder à l’installation de l’application Ferndesk. Demandez à un propriétaire ou à un administrateur de cette organisation GitHub de se connecter.
Fern ne prépare pas de brouillons à partir des demandes de fusion fusionnées
Vérifiez que le dépôt est activé, que sa branche de production est bien celle dans laquelle vous fusionnez et que l’option Créer un brouillon à partir des PR fusionnées n’est pas désactivée dans Fern > Personnaliser > Automatisations. Pour créer des brouillons, l’application GitHub doit être installée. Une simple connexion à GitHub ne suffit pas.