GitHub verbinden

De verbinding van Notion met GitHub stelt je in staat om je ontwikkelingsworkflows naadloos te koppelen. Je kunt GitHub-content direct linken in Notion-pagina's, GitHub-informatie ophalen in Notion-databases en Pull Requests synchroniseren met Notion-taken om je team op de hoogte te houden van de projectstatussen. Lees verder voor meer informatie over de verschillende functies van de verbinding en hoe je deze kunt instellen.

Je moet zowel eigenaar van een Notion workspace als beheerder van een GitHub-organisatie zijn om Notion en de GitHub workspace app te koppelen.

1. Ga naar Instellingen in de zijbalk → koppelingen.

2. Zoek GitHub (Workspace).

3. Klik op Koppelen en doorloop het authenticatieproces.

Link rechtstreeks in Notion naar een bestand of specifieke regels uit een bestand. Je kunt zelfs linken vanaf een specifieke commit of branch als je wilt dat de code waarnaar je verwijst up-to-date is.

1. Kopieer de permalink voor de gewenste regels uit GitHub.

2. Plak deze in een Notion-pagina en selecteer Paste as preview om de code in je pagina in te sluiten.

Je kunt je GitHub-repositories (inclusief Pull Requests en issues) synchroniseren in Notion als databases. Doe hiervoor het volgende:

1. Kopieer in GitHub de link naar een Pull Request of issue.

2. Plak de link in Notion en selecteer Paste as database.

   • Als je dit nog niet hebt gedaan, word je gevraagd om in te loggen en Notion te koppelen aan je GitHub-account.

3. De gesynchroniseerde database wordt gemaakt in een /tabelweergave, waarbij alle GitHub-eigenschappen automatisch worden toegevoegd.

4. De database wordt automatisch ingevuld en blijft synchroniseren wanneer je de pagina verlaat.

Hier is een lijst met GitHub-eigenschappen die we ondersteunen:

Labels en tags worden momenteel niet ondersteund.

Je kunt identiteitstoewijzing gebruiken om GitHub-identiteiten te koppelen aan de Notion-profielen van je team. Doe hiervoor het volgende:

1. Navigeer naar je GitHub-e-mailinstellingen en zorg ervoor dat de instelling Mijn e-mailadressen Privé houdenniet is aangevinkt.

2. Bewerk je GitHub-profiel (https://github.com/{YOUR_USERNAME_HERE}) om je Notion-e-mailadres toe te voegen.

Hiermee kan je identiteit worden gekoppeld aan gesynchroniseerde databases in workspaces waarvan je lid bent.

De GitHub Pull Request-eigenschap in je Notion-database houdt je cross-functionele teams automatisch op de hoogte van taakstatussen. Het heeft ook veel kenmerken die je kunt gebruiken in rollups, formules en filters.

1. Klik in een Notion-database op + om een nieuwe eigenschap toe te voegen.

2. Zoek naar en klik op GitHub Pull Requests om deze eigenschap aan je database toe te voegen.

   • Als je de lijst met GitHub Pull Request-eigenschappen niet ziet, ga dan naar Instellingen → Meer instellingen → Verbindingen → Voeg GitHub Pull Request toe.

3. Zorg ervoor dat je database een Unieke ID-eigenschap heeft. Deze eigenschap wordt aan je database toegevoegd als deze er nog geen heeft.

4. Om de GitHub Pull Request-eigenschap te gebruiken, moet je ervoor zorgen dat je je GitHub-account hebt gekoppeld aan Notion. Voeg vervolgens de unieke ID van de Notion-taak toe aan de Pull Request, of plak de URL van de GitHub Pull Request in de eigenschap.

Standaard schakelt Notion backlinks op Notion-taken naar GitHub in. Als je dit wilt uitschakelen, klik je op de GitHub Pull Request-eigenschap in je database → Eigenschap bewerken. Schakel Linkbacks in GitHub uit.

Je kunt de GitHub Pull Requests-eigenschap gebruiken om de status van je taken in Notion automatisch bij te werken.

1. Selecteer de titel van je GitHub Pull Requests-eigenschap en klik op Eigenschap bewerken.

2. Zoek de sectie Auto-update en selecteer de status-eigenschap die je wilt bijwerken in het vervolgkeuzemenu.

3. Selecteer de taakstatus die moet worden ingesteld wanneer de GitHub Pull Request wordt geopend, review aangevraagd, goedgekeurd en samengevoegd wordt.

4. Wanneer de Pull Request in GitHub vordert, wordt je taakstatus in Notion automatisch bijgewerkt op basis van je instellingen.

Je kunt ook GitHub-activiteit weergeven in de gekoppelde Notion-taak. Klik hiervoor op de GitHub-eigenschap in je database → Eigenschap bewerken. Schakel Activity Comments in.

Als je een GitHub Pull Request wilt koppelen aan een of meer Notion-taken, voer je eenvoudig een magic word en het unieke ID van de Notion-taak in de beschrijving van je Pull Request in.

Magic words zijn trefwoorden die helpen bij het leggen van relaties tussen Notion-taken en GitHub Pull Requests. Je kunt een van de volgende woorden gebruiken:

• close, closes, closed

• fix, fixes, fixed

• resolve, resolves, resolved

• complete, completes, completed, completing

• ref, references

• part of

• Gerelateerd aan

• contributes to

• towards

Je Pull Request kan bijvoorbeeld de beschrijving 'fixes CTT-13' hebben. Zodra die beschrijving is ingesteld, wordt je Notion-taak met het ID CTT-13 gekoppeld aan die Pull Request.

Als je Pull Request-beschrijving magic words gebruikt die geassocieerd worden met het sluiten of voltooien van een taak, wordt de Notion-taak als Gereed gemarkeerd wanneer de Pull Request wordt samengevoegd.

Als je Pull Request-beschrijving magic words gebruikt die geassocieerd worden met het verwijzen naar of gerelateerd zijn aan een taak, wordt de Notion-taak niet als Gereed gemarkeerd wanneer de Pull Request wordt samengevoegd.

Je kunt Notion-taken koppelen als alleen-ter-referentie, zodat die taken niet als Gereed worden gemarkeerd.

Om GitHub los te koppelen van Notion, moet je eigenaar van een Notion workspace zijn.

1. Ga naar Instellingen.

2. Selecteer Koppelingen.

3. Selecteer naast GitHub ••• → Alle gebruikers loskoppelen.

Wanneer je GitHub loskoppelt van Notion, kan niemand in je workspace de verbinding gebruiken totdat deze opnieuw is ingesteld.