Connecter GitHub à Notion

Une synchronisation GitHub gérée importe dans Notion le travail GitHub de votre choix : pull requests, issues ou les deux. Notion importe vos enregistrements existants et recherche les dernières modifications sur GitHub en arrière-plan.

Ce guide couvre la Synchronisation de base de données dans les paramètres de vos connexions GitHub. Les propriétés synchronisées sont en lecture seule. Modifiez les pull requests et les issues dans GitHub.

Choisissez ce que vous souhaitez importer dans Notion parmi les repositories disponibles via une installation d’application GitHub : pull requests, issues ou les deux. Les repositories que vous sélectionnez alimentent Notion.

La propriété Auteur (GitHub) contient le nom d’utilisateur GitHub. Auteur est une propriété de type Personne dans Notion lorsque l’e-mail public disponible de l’auteur correspond à celui d’un membre de l’espace de travail.

La propriété Description synchronise la description de la Pull Request sous forme de texte brut, copiée exactement telle qu’elle est écrite dans GitHub. Elle n’est pas rendue au format markdown.

Vous pouvez synchroniser les issues GitHub seules ou avec des pull requests. Cette synchronisation n’inclut pas les commentaires des pull requests ni les détails des revues de code.

Vous aurez besoin de :

• Être membre de l’espace de travail Notion.

• Un compte GitHub avec accès aux repositories que vous souhaitez synchroniser.

• Une installation d’application GitHub avec accès à ces repositories.

• Un forfait Business (le forfait Mobile Business est également éligible). La synchronisation GitHub n’est pas disponible sur les autres forfaits.

Votre compte GitHub et l'installation de l’application nécessitent tous deux un accès. Votre organisation GitHub peut exiger qu'un Propriétaire approuve ou installe l’application.

1. Dans Notion, accédez à Paramètres → Connexions → GitHub.

2. Ouvrez Synchronisation de base de données et connectez votre compte GitHub si ce n'est pas déjà fait.

3. Terminez les étapes d'autorisation et d'installation de GitHub.

4. Choisissez l'organisation ou le compte dont vous souhaitez synchroniser les repositories. Utilisez Ajouter une organisation… si vous devez ajouter une autre installation.

5. Sélectionnez les repositories à inclure.

6. Nommez votre synchronisation et choisissez ce que vous souhaitez importer dans Notion : pull requests, issues ou les deux.

7. Choisissez tout l'historique disponible ou une fenêtre d'historique.

8. Sélectionnez Créer une synchronisation.

Notion crée la Base de donnée synchronisée dans la section Pages privées de votre barre latérale et commence à importer les enregistrements correspondants.

Lors de la première importation, Notion lit les pull requests et les issues que vous avez choisies dans chaque repository sélectionné, en commençant par les enregistrements les plus récemment mis à jour et en parcourant l’historique sélectionné.

Après l’importation, Notion vérifie régulièrement chaque repository pour détecter les enregistrements nouveaux et mis à jour. Les modifications telles qu’une nouvelle étiquette, une pull request fermée ou une issue rouverte mettront à jour les propriétés correspondantes dans Notion.

La synchronisation s'exécute même lorsque vous fermez Notion. Les repository volumineux, les limites de requêtes GitHub et les problèmes de service temporaires peuvent retarder les Dernières modifications. Vérifiez l'État de la synchronisation pour connaître la progression ou les erreurs.

Choisissez Tout l'historique, 30 derniers jours, 90 derniers jours ou 365 derniers jours. Lorsque la synchronisation de tout l'historique est proposée sous forme de bouton, laissez Synchroniser tout l'historique disponible activé pour inclure toutes les demandes de tirage disponibles.

La fenêtre utilise l'heure Mis à jour le de la Pull Request. Elle ne dépend pas de la date de création de la Pull Request ni du fait qu'elle soit ouverte, fermée ou fusionnée.

Par exemple, une pull request ou une issue ouverte qui n’a pas été modifiée depuis plus de 90 jours peut se trouver en dehors d’une fenêtre de 90 jours.

Ouvrez la synchronisation dans Paramètres → Connexions → GitHub → Synchronisation de base de données.

• Ajouter ou supprimer des issues ou des pull requests : modifiez ce que la synchronisation importe et sélectionnez Enregistrer les modifications. L’ajout d’un type importe les enregistrements correspondants. La suppression d’un type supprime ces pages. Les enregistrements que vous avez déjà importés pour les types conservés restent en place.

• Ajouter des repositories : Modifiez la sélection et sélectionnez Enregistrer les modifications. Notion importe les Pull Requests correspondantes à partir des repositories ajoutés.

• Supprimer des repositories : Désélectionnez-les et enregistrez. Leurs pages de Pull Request synchronisées sont supprimées de Notion.

• Historique des modifications : Une fenêtre plus longue importe des enregistrements supplémentaires. Une fenêtre plus courte supprime les enregistrements en dehors de la nouvelle fenêtre.

• Interrompre les mises à jour : Sélectionnez Interrompre la synchronisation. Les données et paramètres existants sont conservés.

• Reprendre les mises à jour : Sélectionnez Reprendre la synchronisation pour continuer la synchronisation.

Avant de supprimer des repositories ou de raccourcir l'historique, conservez toutes les informations propres à Notion dont vous avez besoin à partir des pages concernées.

Créez des vues par repository, état, auteur ou étiquette. Ajoutez vos propres propriétés pour suivre l’état de préparation à la publication ou connectez les pull requests et les issues au processus de planification de votre équipe. Vos propres valeurs de propriété restent dans Notion.

Pour modifier une propriété GitHub, ouvrez l’enregistrement à l’aide de URL GitHub, puis effectuez la modification dans GitHub.

La base de données commence comme Pages privées. Si vous la partagez, les paramètres de partage de Notion déterminent qui peut voir les données importées. Les spectateurs n'ont pas tous besoin d'accéder au repository source, alors examinez les autorisations de la base de données avant de partager des informations sur un repository privé.

Vérifiez que vous avez sélectionné le bon compte GitHub et la bonne installation d'application. Confirmez que votre compte et l'application ont accès au repository. Si une organisation restreint les installations d'applications, demandez à un Propriétaire d'approuver l'accès.

Ouvrez les paramètres du repository de la synchronisation, vérifiez la sélection du repository et enregistrez-la à nouveau. S'il a été déplacé vers une autre organisation, confirmez que la connexion dispose d'un accès au nouvel emplacement.

Un nom d'utilisateur GitHub n'a pas toujours d'adresse e-mail publique disponible correspondant à un membre de l'espace de travail Notion. Utilisez Auteur (GitHub) pour identifier l'auteur lorsque la propriété de personne est vide. Les modifications apportées à l'adresse e-mail ou à l'appartenance à l'espace de travail d'un auteur peuvent ne pas actualiser automatiquement les anciennes Pull Requests synchronisées.

Vérifiez que son type est inclus dans la synchronisation, que son repository est sélectionné, que sa dernière mise à jour se situe dans la période d’historique choisie et que votre vue Notion ne le masque pas. La première importation est peut-être encore en cours.

Ouvrez les détails du statut de la synchronisation. Reconnectez votre compte GitHub ou restaurez l'accès au repository si vous y êtes invité. Les limites de requêtes GitHub et les pannes temporaires peuvent retarder les mises à jour pendant que Notion réessaie.

Pour une comparaison avec Workers et des conseils de dépannage partagés, consultez Synchroniser des données depuis d'autres outils vers Notion →