Vous devez être connecté à votre espace de travail Ferndesk avant de connecter une intégration. Assurez-vous d'être connecté et de vous trouver dans la bonne organisation. Si vous avez accès à plusieurs espaces de travail Ferndesk, passez à celui où vous souhaitez ajouter la connexion GitHub.
Intégration GitHub
Connectez votre compte GitHub à Ferndesk. Cette intégration permet à Fern de parcourir votre base de code et de comprendre le fonctionnement des fonctionnalités, ce qui aide à générer des articles de centre d'aide plus précis et pertinents.
Regardez cette vidéo pour apprendre comment fonctionne l'intégration GitHub :
Vous aurez besoin d'un compte GitHub pour terminer cette intégration. Si vous n'en avez pas, créez-en un sur le site Web de GitHub.
Connecter GitHub
Go to Integrations
Depuis votre tableau de bord Ferndesk, cliquez sur Intégrations dans la barre latérale.
Assurez-vous d'être connecté au bon espace de travail Ferndesk. L'intégration se connectera à l'organisation que vous consultez actuellement.
Click Connect
Trouvez GitHub dans la liste des intégrations et cliquez sur Connect.
Authorize in GitHub
Vous serez redirigé vers GitHub pour autoriser la connexion. Connectez-vous à votre compte GitHub si ce n'est pas déjà fait.
Accordez à Ferndesk la permission d'accéder à votre compte GitHub. Vous pouvez sélectionner les dépôts à connecter — vous pouvez choisir plusieurs dépôts si votre projet s'étend sur plusieurs répertoires, comme un backend et un tableau de bord dans des dépôts distincts.
Return to Ferndesk
Après l'autorisation, vous serez redirigé vers Ferndesk. L'intégration GitHub apparaîtra comme connectée, et Fern pourra parcourir votre base de code.
Une fois connecté, Fern peut parcourir votre base de code pour fournir des articles de centre d'aide plus précis et pertinents.
Gérer les dépôts connectés
Après votre configuration initiale, vous pouvez ajouter ou supprimer des dépôts en consultant les paramètres de votre application GitHub. Go to your GitHub account settings, navigate to Applications, and find Ferndesk in your installed integrations to adjust repository access.
Dépannage
Je vois « Authentication required to connect GitHub »
Je vois « GitHub OAuth organization does not match the active session »
Le compte ou l'organisation GitHub que vous autorisez appartient à une organisation différente de celle à laquelle vous êtes connecté dans Ferndesk. Assurez-vous de :
Être connecté au bon espace de travail Ferndesk
Autoriser le compte ou l'organisation GitHub qui correspond à cette organisation Ferndesk
Si vous devez connecter une organisation GitHub différente à un espace de travail Ferndesk différent, passez d'abord à cet espace de travail dans Ferndesk, puis connectez GitHub.
La page d'autorisation GitHub affiche une erreur
Cela peut se produire si :
Votre session a expiré — essayez de vous déconnecter de Ferndesk et de vous reconnecter
L'état OAuth est devenu invalide — fermez la fenêtre d'autorisation et cliquez à nouveau sur Connect dans Ferndesk
Ressources supplémentaires
Pour plus d'informations sur les fonctionnalités de GitHub, visitez leur Documentation.