Integration von GitHub
Du kannst Notion und GitHub verbinden, um deine Workflows immer aktuell zu halten 🧮
Entwickler/-innen und Unternehmen nutzen GitHub für die Entwicklung, Auslieferung und Wartung ihrer Software. Und auch du kannst die leistungsstarken Notion-Datenbanken mit ihren Filtern, Ansichten, Verknüpfungen und vielen weiteren Funktionen verwenden, um GitHub in deine Notion-Abläufe einzubinden.
Du musst Besitzer/-in des Notion Workspaces und GitHub Admin sein, um beide Apps miteinander verbinden zu können.
Klicke in der Seitenleiste oben auf
Einstellungen
.Gehe nun auf
Meine Verknüpfungen
und suche dort nachGitHub (Workspace)
.Klicke auf
Verknüpfen
und befolge die angezeigten Schritte.
Verknüpfe direkt in Notion eine Datei oder bestimmte Zeilen aus einer Datei. Du kannst sogar von einem bestimmten Commit oder Branch verlinken, wenn du möchtest, dass der Code, auf den du verweist, aktuell ist.
Kopiere dazu einfach den Permalink für deine gewünschten Zeilen von GitHub und füge ihn in eine Notion-Seite ein. Wähle im angezeigten Menü Als Vorschau einfügen
aus, um den Code in deine Seite einzubetten.
Damit du GitHub-PRs in Notion verlinken kannst, muss die Datenbank eine eindeutige ID-Eigenschaft mit Namenszusatz enthalten.
Die GitHub Pull Request-Eigenschaft in deiner Notion-Datenbank informiert deine funktionsübergreifenden Teams stets über den Status der Aufgaben. Sie verfügt außerdem über viele Eigenschaften, die du in Rollups, Formeln und Filtern verwenden kannst.
Klicke in einer Notion-Datenbank auf
+
, um eine neue Eigenschaft hinzuzufügen.Suche nach
GitHub Pull Requests
und klicke darauf, um diese Eigenschaft zu deiner Datenbank hinzuzufügen.Stelle sicher, dass deine Datenbank über die Eigenschaft Eindeutige ID verfügt. Diese Eigenschaft wird deiner Datenbank hinzugefügt, falls noch keine vorhanden ist.
Um die GitHub Pull Request-Eigenschaft zu verwenden, musst du dein GitHub-Konto mit Notion verbinden. Füge dann entweder die eindeutige ID der Notion-Aufgabe zur Pull Request hinzu oder füge die URL der GitHub Pull Request in die Eigenschaft ein.
Standardmäßig aktiviert Notion Backlinks für Notion-Aufgaben in GitHub. Wenn du dies deaktivieren möchtest, klicke auf die Eigenschaft „GitHub Pull Request“ in deiner Datenbank → Eigenschaft bearbeiten
. Deaktiviere Linkbacks in GitHub
.
Automatische Hinweise zum Aufgabenstatus einrichten
Du kannst die GitHub Pull Requests Eigenschaft verwenden, um den Status deiner Aufgaben in Notion automatisch zu aktualisieren.
Klicke den Namen der
GitHub Pull Requests
Eigenschaft an und gehe dann aufBearbeiten
.Unter
Automatische Aktualisierung
kannst du nun über das Dropdown-Menü diejenige Eigenschaft auswählen, deren Status laufend aktualisiert werden soll.Wähle aus, welcher Aufgabenstatus angezeigt werden soll, wenn die GitHub PR geöffnet, zur Überprüfung vorgelegt, freigegeben oder zusammengeführt wird.
Wenn die PR nun in GitHub bearbeitet wird, ändert sich der Aufgabenstatus in Notion automatisch entsprechend deiner Einstellungen.
Du kannst die GitHub-Aktivität auch in der verknüpften Notion-Aufgabe anzeigen. Klicke dazu auf die GitHub-Eigenschaft in deiner Datenbank → Eigenschaft bearbeiten
. Aktiviere Aktivitätskommentare
.
Verwende magische Worte, um GitHub-PRs mit Notion-Aufgaben zu verknüpfen
Wenn du eine GitHub-PR mit einer oder mehreren Notion-Aufgaben verknüpfen möchtest, gib einfach magische Wörter und die eindeutige ID der Notion-Aufgaben in die Beschreibung deiner PR ein.
Magische Wörter sind Schlüsselwörter, die helfen, Beziehungen zwischen Notion-Aufgaben und GitHub-PRs herzustellen. Du kannst eines der folgenden Wörter verwenden:
close, closes, closed
fix, fixes, fixed
resolve, resolves, resolved
complete, completes, completed, completing
ref, references
part of
related to
contributes to
towards
Deine PR könnte zum Beispiel die Beschreibung „fixes CTT-13“ haben. Sobald diese Beschreibung festgelegt ist, wird deine Notion-Aufgabe mit der ID CTT-13 mit dieser PR verknüpft.
Wenn deine PR-Beschreibung magische Wörter verwendet, die mit dem Schließen oder Beenden einer Aufgabe verbunden sind, wird die Notion-Aufgabe als erledigt markiert, wenn die PR zusammengeführt wird.
Wenn deine PR-Beschreibung magische Wörter verwendet, die sich auf eine Aufgabe beziehen, wird die Notion-Aufgabe nicht als erledigt markiert, wenn die PR zusammengeführt wird.
Du kannst Notion-Aufgaben nur als Referenz verknüpfen, sodass diese Aufgaben nicht als erledigt markiert werden.