Hubungkan GitHub

Koneksi Notion dengan GitHub memungkinkan Anda untuk menghubungkan alur kerja pengembangan Anda dengan lancar. Anda dapat menautkan konten GitHub secara langsung di halaman Notion, menarik informasi GitHub ke dalam database Notion, dan menyinkronkan pull request dengan tugas Notion untuk menjaga tim Anda tetap terinformasi mengenai status proyek. Baca terus untuk mempelajari berbagai fitur koneksi ini dan cara Anda dapat mengaturnya.

Anda harus menjadi pemilik ruang kerja Notion dan admin organisasi GitHub untuk menghubungkan Notion dan aplikasi ruang kerja GitHub.

1. Buka Settings di bilah sisi → Koneksi.

2. Temukan GitHub (ruang kerja).

3. Klik Connect dan ikuti alur autentikasi.

Tautkan ke file atau baris tertentu dari file secara langsung di Notion. Anda bahkan dapat menautkan dari commit atau branch tertentu jika Anda ingin kode yang Anda referensikan selalu diperbarui.

1. Salin permalink untuk baris yang Anda inginkan dari GitHub.

2. Tempel ke dalam halaman Notion dan pilih Paste as preview untuk menyematkan kode ke dalam halaman Anda.

Anda dapat menyinkronkan repositori GitHub Anda (termasuk pull request dan issue) ke dalam database Notion. Untuk melakukannya:

1. Di GitHub, salin tautan ke PR atau issue.

2. Tempel tautan tersebut ke dalam Notion dan pilih Paste as database.

   • Jika Anda belum melakukannya, Anda akan diminta untuk masuk dan menghubungkan Notion dengan akun GitHub Anda.

3. Database yang disinkronkan akan dibuat dalam table view, dengan semua properti GitHub ditambahkan secara otomatis.

4. Database akan mulai terisi secara otomatis dan akan terus disinkronkan jika Anda menavigasi keluar dari halaman tersebut.

Berikut adalah daftar properti GitHub yang kami dukung:

Label dan tag tidak didukung saat ini.

Anda dapat menggunakan pemetaan identitas untuk menghubungkan identitas GitHub ke profil Notion tim Anda. Untuk melakukannya:

1. Buka GitHub email settings Anda dan pastikan pengaturan Keep my email addresses privatetidak dicentang.

2. Di profil GitHub Anda (https://github.com/{YOUR_USERNAME_HERE}), edit profil Anda untuk menambahkan alamat email Notion Anda.

Ini memungkinkan identitas Anda dipetakan ke database yang disinkronkan di ruang kerja tempat Anda menjadi anggota.

Properti GitHub Pull Request di dalam database Notion Anda akan secara otomatis memberi tahu tim lintas fungsi Anda tentang status tugas. Properti ini juga memiliki banyak atribut yang dapat Anda gunakan dalam rollup, Formula, dan filter.

1. Di database Notion, klik + untuk menambahkan properti baru.

2. Cari dan klik GitHub Pull Requests untuk menambahkan properti ini ke database Anda.

   • Jika Anda tidak melihat daftar properti GitHub Pull Requests, buka Settings → More Settings → Koneksi → Tambahkan GitHub Pull Request.

3. Pastikan database Anda memiliki Unique ID property. Properti ini akan ditambahkan ke database Anda jika belum memilikinya.

4. Untuk menggunakan properti GitHub Pull Request, pastikan Anda telah menghubungkan akun GitHub Anda dengan Notion. Kemudian, tambahkan Unique ID tugas Notion ke pull request, atau tempel URL pull request GitHub ke dalam properti tersebut.

Secara default, Notion mengaktifkan backlink pada tugas Notion ke GitHub. Jika Anda ingin menonaktifkannya, klik properti GitHub Pull Request di database Anda → Edit property. Tekan tombol Linkbacks in GitHub untuk mematikannya.

Anda dapat menggunakan properti GitHub Pull Requests untuk memperbarui status tugas Anda di Notion secara otomatis.

1. Pilih judul properti GitHub Pull Requests Anda dan klik Edit property.

2. Temukan bagian Auto-update dan pilih properti status yang ingin Anda perbarui dari menu drop-down.

3. Pilih status tugas yang akan ditetapkan saat GitHub PR Dibuka, Diminta Peninjauan, Disetujui, dan Digabungkan.

4. Sekarang, saat PR berlanjut di GitHub, status tugas Anda di Notion akan diperbarui secara otomatis berdasarkan pengaturan Anda.

Anda juga dapat menampilkan aktivitas GitHub di tugas Notion yang ditautkan. Untuk melakukannya, klik properti GitHub di database Anda → Edit property. Aktifkan Aktivitas Comments.

Jika Anda ingin menautkan GitHub PR ke satu atau beberapa tugas Notion, cukup masukkan kata ajaib dan unique ID tugas Notion di deskripsi PR Anda.

Kata ajaib adalah kata kunci yang membantu membangun hubungan antara tugas Notion dan GitHub PR. Anda dapat menggunakan kata-kata berikut ini:

• close, closes, closed

• fix, fixes, fixed

• resolve, resolves, resolved

• complete, completes, completed, completing

• ref, references

• part of

• related to

• contributes to

• towards

Sebagai contoh, PR Anda dapat memiliki deskripsi “fixes CTT-13”. Setelah deskripsi tersebut ditetapkan, tugas Notion Anda dengan ID CTT-13 akan ditautkan dengan PR tersebut.

Jika deskripsi PR Anda menggunakan kata ajaib yang terkait dengan penutupan atau penyelesaian tugas, tugas Notion akan ditandai sebagai selesai saat PR digabungkan.

Jika deskripsi PR Anda menggunakan kata ajaib yang terkait dengan perujukan atau keterkaitan dengan tugas, tugas Notion tidak akan ditandai sebagai selesai saat PR digabungkan.

Anda dapat menautkan tugas Notion sebagai referensi saja, sehingga tugas tersebut tidak akan ditandai sebagai selesai.

Untuk memutuskan sambungan GitHub dari Notion, Anda harus menjadi pemilik ruang kerja Notion.

1. Buka Pengaturan.

2. Pilih Koneksi.

3. Di samping GitHub, pilih ••• → Putuskan sambungan semua pengguna.

Saat Anda memutuskan sambungan GitHub dari Notion, tidak ada seorang pun di ruang kerja Anda yang dapat menggunakan koneksi tersebut sampai koneksi disiapkan kembali.