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.

Vous pouvez 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 se mette à jour automatiquement.

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é Pull Request GitHub 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 Request 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 ajoute sur les pages des liens entrants pointant vers GitHub. Vous pouvez désactiver cette option en cliqaunt sur la propriété Pull Request GitHub dans votre base de données → Modifier la propriété. Désactivez Liens entrants vers 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. Cliquez sur la propriété GitHub dans votre base de données → Modifier la propriété. Activez Activité GitHub dans les commentaires.

Si vous souhaitez associer une PR à une ou plusieurs tâches Notion directement depuis GitHub, vous pouvez utiliser un « mot magique » et l’identifiant unique des tâches Notion dans la description de votre PR.

Les « mots magiques » sont des mots-clefs (en anglais) qui permettent d’établir des relations entre des tâches de Notion et des PR GitHub. Vous pouvez utiliser les mots suivants :

• close, closes, closed

• fix, fixes, fixed

• resolve, resolves, resolved

• complete, completes, completed, completing

• ref, references

• part of

• related to

• contributes to

• towards

Par exemple, votre PR pourrait avoir la description « fixes CTT-13 ». Une fois cela écrit dans la description de votre PR, la tâche Notion avec l’identifiant CTT-13 sera associée à cette PR.

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 du « merge » 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 du « merge » 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.