Intégration GitHub

GitHub aide les équipes de développement et les entreprises à créer des logiciels, les mettre sur le marché et en assurer la maintenance. Connectez GitHub à vos processus Notion en tirant parti de la puissance des bases de données Notion (filtres, vues, relations, etc.).

Vous devez être à la fois propriétaire de l’espace de travail de Notion et administrateur de l’organisation GitHub pour connecter Notion et l’application GitHub workspace.

• En haut de la barre latérale, cliquez sur Paramètres et membres.

• Cliquez sur Mes connexions et recherchez GitHub (Workspace).

• Cliquez sur Connecter et suivez le processus d’authentification.

Créez un lien vers un fichier ou des lignes spécifiques d’un fichier directement depuis Notion. Vous pouvez même créer un lien à partir d’un commit ou d’une branche spécifique si vous souhaitez que le code auquel vous faites référence soit à jour.

Pour ce faire, copiez simplement le lien permanent des lignes souhaitées depuis GitHub et collez-le dans une page Notion. Dans le menu qui apparaît, sélectionnez Coller en tant qu’aperçu pour intégrer le code dans votre page.

La propriété GitHub Pull Request dans votre base de données Notion tiendra automatiquement vos équipes informées de l’état des tâches. Elle possède également de nombreux attributs que vous pouvez utiliser dans les agrégations, les formules et les filtres.

• Dans une base de données Notion, cliquez sur le signe + pour ajouter une propriété.

• Recherchez l’option Pull Requests GitHub et cliquez dessus pour ajouter cette propriété à votre base de données.

• Assurez-vous que votre base de données possède une propriété Identifiant unique. Cette propriété sera ajoutée à votre base de données si elle ne s'y trouve pas déjà.

• Pour utiliser la propriété Pull Request GitHub, assurez-vous d’avoir connecté votre compte GitHub à Notion. Ensuite, ajoutez l’identifiant unique de la tâche Notion à la pull request ou collez l’URL de la pull request GitHub dans la propriété.

Par défaut, Notion active les liens entrants des tâches Notion pointant vers GitHub. Si vous souhaitez désactiver cette option, cliquez sur la propriété Pull Request GitHub dans votre base de données → Modifier la propriété. Désactivez Liens entrants dans GitHub.

Vous pouvez utiliser la propriété GitHub Pull Requests pour mettre à jour automatiquement l’état de vos tâches dans Notion.

• Sélectionnez le titre de la propriété Pull Requests GitHub et cliquez sur Modifier la propriété.

• Dans la section Mise à jour automatique, sélectionnez la propriété d’état que vous souhaitez mettre à jour dans le menu déroulant.

• Sélectionnez l’état des tâches à définir lorsque celui de la PR GitHub est à l’état « Ouverte », « Revue demandée », « Approuvée » ou « Fusionnée ».

• Au fur et à mesure que cette PR avancera dans GitHub, l’état de votre tâche Notion sera automatiquement mis à jour en fonction de vos paramètres.

Vous pouvez également afficher l’activité GitHub dans la tâche Notion liée. Pour ce faire, cliquez sur la propriété GitHub dans votre base de données → Modifier la propriété. Activez Commentaires sur les activités.

Si vous souhaitez associer une PR GitHub à une ou plusieurs tâches Notion, entrez simplement un mot magique et l’identifiant unique des tâches Notion dans la description de votre PR.

Les mots magiques sont des mots clés qui permettent d’établir des relations entre des tâches de Notion et des PR GitHub. Vous pouvez utiliser l’un des mots suivants :

• fermer, ferme, fermé

• correction, corriger, corrigé

• résoudre, résout, résolu

• terminer, termine, terminé

• réf, références

• partie de

• associé à

• contribue à

• vers

Par exemple, votre PR pourrait avoir la description « corrige CTT-13 ». Une fois cette description définie, la tâche Notion avec l’identifiant CTT-13 sera associée à cette pull request.

Si la description de votre PR utilise des mots magiques associés à la fermeture ou à la fin d’une tâche, la tâche Notion sera marquée comme terminée lors de la fusion de la PR.

Si la description de votre PR utilise des mots magiques associés à une référence ou à une relation avec une tâche, la tâche Notion ne sera pas marquée comme terminée lors de la fusion de la PR.

Vous pouvez associer des tâches Notion à des fins de référence uniquement afin que ces tâches ne soient pas marquées comme terminées.