Integration von GitHub

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 nach GitHub (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.

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.

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 auf Bearbeiten.

• 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.

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.