- GitHub Issues adalah alat yang kuat untuk catatan publik/pribadi dan kolaborasi, sekaligus gratis
- Dengan dukungan Markdown, penyorotan kode, drag-and-drop gambar dan video, serta fitur saling taut, alat ini memberi pengalaman menulis catatan yang sangat baik
- Fitur pencarian yang kuat dan otomatisasi, backup, serta integrasi eksternal melalui API juga dimungkinkan
- Satu-satunya kekurangan adalah tidak adanya fitur offline yang tersinkronisasi, sehingga sulit digunakan saat tidak ada koneksi jaringan
- Checklist, penanganan skala besar, pemanfaatan terhubung LLM, serta backup data dan keamanan juga menjadi keunggulan utama
Nilai GitHub Issues untuk penggunaan catatan
- GitHub Issues layak disebut hampir sebagai notebook online terbaik
- Pengguna dapat membuat dan mengelola catatan publik maupun pribadi tanpa batas secara gratis
- Dukungan format Markdown sangat unggul, menyediakan syntax highlighting untuk hampir semua bahasa pemrograman, dan juga memungkinkan gambar diseret langsung ke dalam catatan
Fitur tautan dan interlink
- Jika URL issue lain ditambahkan sebagai daftar Markdown di dalam issue, sistem akan secara otomatis memuat judulnya dan membuat tautan timbal balik secara otomatis
- Aturan visibilitas issue tetap berlaku, sehingga issue privat tidak terekspos ke luar
Pencarian kuat dan otomatisasi API
- Keunggulannya adalah pencarian yang cepat dan akurat di dalam satu repositori, seluruh repositori milik pengguna, maupun seluruh GitHub
- Dengan API, data catatan bisa dengan mudah diekspor atau digunakan untuk membuat dan mengubah catatan baru
- Dengan menghubungkan event Issue ke GitHub Actions, otomatisasi juga dapat diimplementasikan secara luas
Kekurangan: tidak ada sinkronisasi offline
- Satu-satunya kelemahan adalah tidak ada sinkronisasi saat koneksi internet tidak tersedia
- Karena itu, di perangkat mobile orang cenderung memakai aplikasi yang mendukung offline/sinkronisasi seperti Apple Notes secara berdampingan
Keamanan, kemudahan, checklist, dan skalabilitas besar
- Kekhawatiran soal keamanan relatif rendah. Perusahaan berinvestasi pada keandalan GitHub, dan tingkat kepercayaan terhadap platform ini tinggi
- Karena semua platform catatan memiliki risiko kebocoran akibat bug, data sensitif sebaiknya tidak disimpan
- Karena tidak memerlukan biaya atau self-hosting, risiko kehilangan catatan menjadi lebih kecil
- Checklist Markdown (
- [ ] item) maupun referensi issue (- [ ] #ref) sangat berguna
- Jika issue tersebut ditutup, kotaknya akan otomatis tercentang
- Berbagai metode backup (misalnya github-to-sqlite) juga bisa dicoba
- Skalabilitasnya juga sangat baik; ada contoh pengelolaan lebih dari 190 ribu issue di repositori vscode dan lebih dari 100 ribu issue di repositori flutter
LLM dan pemanfaatan lainnya
- Data issue juga mudah dialirkan melalui pipeline ke LLM dan AI generatif lainnya
- Ada pengalaman nyata merangkum thread issue selama 1,5 tahun dengan lebih dari 50 komentar, lalu menyusunnya menjadi komentar baru
Agregasi dan pemanfaatan data aktivitas
- Jumlah issue dan komentar yang dibuat di GitHub dapat dihitung dengan query GraphQL
{
viewer {
issueComments {
totalCount
}
issues {
totalCount
}
}
}
- Hasil nyatanya adalah 9.413 issue, 39.087 komentar, total 48.500 item atas nama penulis
Kesimpulan
- GitHub Issues unggul dalam hal gratis, kolaborasi, otomatisasi, pencarian, skalabilitas, dan kegunaan
- Jika sinkronisasi offline ditambahkan, ini pada praktiknya akan menjadi solusi notebook digital terbaik
1 komentar
Opini Hacker News
Berbagi pengalaman menggunakan GitHub Issues sebagai alat manajemen proyek saat menyiapkan pernikahan dulu. Awalnya istrinya meragukan, tetapi karena kolaborasi seperti penambahan label dan pencarian menjadi sangat mudah, semua tugas persiapan pernikahan bisa selesai tepat waktu. Bagian tersulit yang diingat justru membuat bookmark yang langsung menuju issue tracker. Saat baru-baru ini pindahan pun GitHub Issues dipakai untuk mengatur kotak. Setiap kotak dibuatkan issue, isi kotak ditulis di kolom deskripsi, lalu nomor issue ditulis di kotaknya, sehingga nanti bisa dengan mudah mencari kotak mana berisi apa lewat pencarian GitHub
Bertanya apakah selain ini pernah mencoba solusi lain, dan kenapa solusi tersebut terasa kurang memadai
Penasaran secara sederhana, bukankah cukup menulis isi barang langsung di bagian luar kotak
Ini mengingatkan pada cerita proyek renovasi rumah yang pernah dilihat di Hacker News. Sekarang tampaknya sudah hilang dari GitHub, jadi diperkenalkan tautan proyek tersebut
Di tempat kerja sebelumnya pernah mencoba memakai GitLab sebagai alat manajemen proyek menyeluruh, tetapi adopsinya terhenti karena tidak ada fitur referensi antarproyek. Cocok untuk proyek open source, tetapi di perusahaan saat ini GitLab bisa menggantikan Youtrack, dan bahkan sudah menggantikan Upsource
Jadi teringat komik xkcd episode 1172. Ada banyak kisah lucu seperti ini, dan cukup banyak orang di dunia yang punya workflow aneh. Hal seperti ini memang selalu lebih baik ditangani dengan alat yang tepat. Sebagai catatan, pernah juga mengatur pekerjaan saat pindah antarnegara memakai Org mode. Secara pribadi sama sekali tidak mau menyerahkan informasi pribadi ke Microsoft
Fakta menarik: jika menempelkan query GraphQL berikut ke GitHub GraphQL Explorer, kita bisa langsung melihat jumlah total issue dan komentar yang pernah diunggah ke GitHub
Orang ini mencatat total 48.500, terdiri dari 9.413 issue dan 39.087 komentar
Mengira komentar pertama akan membahas privasi, ternyata tidak. Penulis sendiri tidak terlalu banyak meninggalkan catatan, tetapi menganggapnya sebagai data yang bahkan lebih pribadi daripada email. Tidak ingin data pribadi seperti ini dipakai untuk melatih LLM. Bertanya-tanya apakah Microsoft memberikan jaminan apa pun terkait privasi private repository
Karena begitu banyak rahasia perusahaan yang sangat sensitif ada di GitHub Issues, diduga keamanan dan privasinya pasti sangat kuat. Banyak perusahaan membayar GitHub mahal untuk menitipkan source code dan artefak terkait, jadi membangun kepercayaan adalah inti model bisnis GitHub. Menurut pendapat ini, mereka tidak akan mengambil risiko melatih model dengan rahasia pelanggan sendiri
Memperkenalkan tautan diskusi terkait pertanyaan, "apakah Microsoft menjamin privasi private repository", di sini
Meragukan klaim bahwa "pencarian GitHub itu hebat". Misalnya, meskipun ada komentar yang persis berisi "current logs could do with a bit of redesign", hasilnya baru bisa ditemukan jika dibungkus tanda kutip, dan pencarian juga gagal jika ada typo seperti "redesing"
Seperti saya, banyak orang mencoba mencari aplikasi catatan terbaik dan pada akhirnya selalu kembali ke menumpuk file Markdown di repo Git
Jika ingin terus memakai pendekatan ini, dibagikan pengalaman bahwa kombinasi Obsidian + Git Plugin adalah yang terbaik. Di desktop berjalan fantastis, tetapi di iOS perlu sedikit setup
Saran untuk mencoba aplikasi catatan gratis dan open source. Sambil mengungkapkan bahwa dirinya adalah pelanggan pengembangnya, diperkenalkan em sebagai aplikasi catatan yang indah dan minimalis untuk merapikan pemikiran pribadi
Dibanding aplikasi yang punya sinkronisasi dua arah otomatis di semua perangkat, cara yang mengharuskan commit/push/pull manual setiap kali membuat atau mengubah catatan terasa kuno
Sama juga di sini, hanya saja memakai file Org-mode alih-alih Markdown, lalu sesekali menambahkan tag org-roam saat diperlukan
Berbagi pengalaman menyiksa bolak-balik antara Apple Notes dan folder Markdown. Folder Markdown bagus untuk kompatibilitas masa depan, tetapi Apple Notes unggul dalam desain, kesederhanaan, dan dukungan media. Semakin banyak fitur yang didukung aplikasi Markdown, semakin tertutup aplikasinya, dan aplikasi pembaca pun harus mendukung semua fitur itu. Pada akhirnya tetap bertahan di Apple Notes, tetapi kali ini lagi-lagi sedang melakukan kerja manual memindahkan ke folder Markdown lewat Obsidian. Sudah mencoba ekspor, tetapi formatnya berantakan sehingga semua catatan harus diperbaiki satu per satu
Dengan opsi "keep downloaded" di iCloud, kini semua folder dan file bisa disimpan secara lokal. Akibatnya, semua aplikasi yang menyimpan file di iCloud jadi mendukung kerja offline sekaligus sinkronisasi otomatis online
Penasaran bagaimana penanganan konflik sinkronisasi dan seberapa sering siklus sinkronisasinya berjalan
Bertanya apakah saat memindahkan folder iCloud masih memakai cara mengunduh lalu mengunggah ulang
Memperkenalkan alternatif memakai Codeberg atau meng-host Forgejo sendiri untuk menghindari vendor lock-in
Pandangan bahwa GitHub Issues adalah bug tracker/sistem ticketing terbaik. Dipuji karena antarmukanya intuitif, sederhana, dan cepat. Hanya saja ada sedikit kekhawatiran akan rusak karena redesign Microsoft
Dalam pekerjaan pernah memakai berbagai issue tracker, tetapi merasa GitHub kekurangan beberapa fitur penting. Secara spesifik: tidak bisa menulis ringkasan issue secara terpisah dari komentar, kurangnya kontrol akses tingkat lanjut (misalnya issue tertentu hanya terlihat bagi sebagian orang), dan tidak adanya catatan pribadi tertutup untuk ditulis sementara alih-alih komentar publik
Ungkapan metaforis bahwa tujuan Azure DevOps sendiri seperti "sumur gravitasi" yang mencegah filosofi marketing Microsoft terserap ke GitHub
Menunjukkan bahwa keterbukaannya sudah berkurang, misalnya dengan adanya login wall dan pembatasan cepat terhadap jumlah issue yang bisa dicari
Disayangkan tidak adanya fitur federasi. Sentralisasi repositori sumber dalam skala besar dianggap struktur yang harus dihindari oleh komunitas developer secara keseluruhan. Fitur merge request terfederasi GitLab (issue terkait) sudah 9 tahun tanpa kabar. Padahal hanya dengan fitur ini, semua orang bisa berkolaborasi seperti git tanpa harus memakai sistem tersentralisasi. Sebagai catatan, diperkenalkan kisah bahwa belum lama ini Microsoft memblokir akun email jaksa ketua Mahkamah Pidana Internasional atas perintah pemerintah AS. Ironisnya, ini terjadi tidak lama setelah mereka beriklan bahwa mereka akan melawan Uni Eropa. Trump tidak tahan dengan UE, dan ada kemungkinan suatu hari dia meminta Microsoft memblokir akses UE ke GitHub, dan itu memang bisa dilakukan. Peringatan agar memikirkan baik-baik dampaknya bagi bisnis dan open source jika hal seperti itu terjadi
Ada pendapat bahwa bukan hanya teknologi Tiongkok, keandalan teknologi AS juga sudah menjadi tidak stabil, sehingga lembaga publik atau pemerintah perlu benar-benar meninjau kembali ketergantungan pada teknologi negara tertentu
Ingin mencoba alternatif seperti Radicle. Kalau menunggu sampai keadaan memburuk, rasanya nanti hanya akan menyesal
Hampir mirip Obsidian, hanya terasa sedikit lebih banyak prosedur
Salah satu prosedur itu mungkin berupa pembayaran seperti "bayar $50 per tahun untuk akses dari semua perangkat" atau "bayar $100 per tahun untuk akses via web", canda seseorang
Sebenarnya Obsidian juga terasa seperti teks file dengan sedikit prosedur tambahan. Tetapi pada dasarnya teks file sendiri sangat kuat, dan ada berbagai cara untuk sinkronisasi antarperangkat
Tidak seperti Obsidian, GitHub Issues hanya online. Jika tidak bisa dibackup, itu jelas menjadi masalah
Penasaran apakah Obsidian bisa di-self-host. Untuk penggunaan kerja, ada kekhawatiran soal keamanan, sehingga diusulkan pendekatan menyimpannya hanya secara lokal dan membackup file Markdown saja ke OneDrive