Ferndesk
Intégrations

Intégration GitHub

Connectez votre compte GitHub à Ferndesk afin que Fern puisse parcourir votre base de code et comprendre le fonctionnement des fonctionnalités, ce qui aide à générer des articles du centre d’aide plus précis et plus pertinents.

Vous avez 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

  1. Depuis votre tableau de bord Ferndesk, cliquez sur Intégrations dans la barre latérale.

    Page Intégrations montrant la grille des cartes d’intégration disponibles
  2. Trouvez la carte GitHub et cliquez sur Connecter.

    Carte d’intégration GitHub avec le bouton Connecter mis en évidence
  3. Vous serez redirigé vers GitHub pour autoriser la connexion. Connectez-vous à votre compte GitHub si vous n’êtes pas déjà connecté.

  4. Accordez à Ferndesk l’autorisation 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 dépôts, par exemple un backend et un tableau de bord dans des dépôts distincts.

  5. Après l’autorisation, vous serez redirigé vers Ferndesk. L’intégration GitHub s’affichera comme connectée.

Une fois connecté, Fern peut parcourir votre base de code afin de fournir des articles du centre d’aide plus précis et plus pertinents.

Gérer les dépôts connectés

Après la configuration initiale, vous pouvez ajouter ou supprimer des dépôts en accédant aux paramètres de votre application GitHub. Allez dans les paramètres de votre compte GitHub, ouvrez Applications, puis trouvez Ferndesk dans vos intégrations installées pour modifier l’accès aux dépôts.

Périmètre du dépôt et de la branche

Lorsque Fern parcourt votre base de code, il peut cibler un dépôt ou une branche spécifique de votre compte GitHub connecté au lieu de se baser uniquement sur le dépôt par défaut.

Si vous avez connecté plusieurs dépôts, Fern peut se concentrer sur le dépôt pertinent pendant l’analyse. Pour un travail spécifique à une branche, comme la revue d’une fonctionnalité non publiée ou d’une pull request, Fern peut aussi parcourir une branche précise lorsqu’elle est fournie.

Pour permettre à Fern de parcourir un dépôt, assurez-vous qu’il est connecté dans votre intégration GitHub. Allez dans les paramètres de votre compte GitHub, ouvrez Applications, puis trouvez Ferndesk pour ajouter ou supprimer l’accès aux dépôts.

Dépannage

Je vois « Authentification requise pour connecter GitHub »

Vous devez être connecté à votre espace de travail Ferndesk avant de connecter une intégration. Vérifiez que vous êtes bien connecté et que vous êtes dans la bonne organisation. Si vous avez accès à plusieurs espaces de travail Ferndesk, basculez vers celui dans lequel vous souhaitez ajouter la connexion GitHub.

Je vois « L’organisation GitHub OAuth ne correspond pas à la session active »

Le compte ou l’organisation GitHub que vous autorisez appartient à une organisation différente de celle sur laquelle vous êtes connecté dans Ferndesk. Assurez-vous de :

  • Être connecté au bon espace de travail Ferndesk

  • Autoriser le compte ou l’organisation GitHub correspondant à cette organisation Ferndesk

Si vous devez connecter une autre organisation GitHub à un autre espace de travail Ferndesk, basculez d’abord vers 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, puis de vous reconnecter.

  • L’état OAuth est devenu invalide. Fermez la fenêtre d’autorisation, puis cliquez à nouveau sur Connecter dans Ferndesk.

Ressources supplémentaires

Pour plus d’informations sur les fonctionnalités GitHub, consultez la documentation GitHub.

Cela vous a-t-il été utile ?