Halaman ini merupakan panduan dalam mengunggah notebook ke repo hidrokit-nb. Tidak diperlukan pengetahuan Git/Github untuk mengunggah notebook melalui GitHub.

Daftar Isi

  1. Persiapan
  2. Unggah Notebook ke hidrokit-nb
    1. Fork hidrokit-nb
    2. Upload Files
    3. Pull Request
  3. Bacaan lebih lanjut

Persiapan

  1. Notebook yang dimaksud adalah file berekstensi .ipynb.
  2. Menamai file dengan format pemilik-judul.ipynb atau pemilik-judul-v0.ipynb jika memiliki nomor versi (isi spasi dengan -). Gunakan nama username GitHub untuk konsistensi.
  3. Pastikan notebook sudah tertera lisensinya (baca: Lisensi Notebook).
  4. Memiliki akun GitHub (jika belum, daftar disini).
  5. Dilakukan melalui komputer (desktop).

Unggah Notebook ke hidrokit-nb

Jika ini bukan pengalaman pertama dalam mengunggah notebook / pull request di repo hidrokit-nb, baca Pull Request.

Fork hidrokit-nb

Fork Button
  • Akan muncul proses forking.
Forking
  • Tunggu proses fork selesai.

Upload Files

  • Setelah proses fork selesai. Klik notebook pada daftar folder.
clicking notebook directory
  • Klik Upload files. Pastikan bahwa Anda berada di direktori hidrokit-nb/notebook/.
click upload files
  • Akan terbuka halaman untuk mengunggah file. Anda bisa mengupload dengan cara drag files atau mengklik pilihan choose your files. Pastikan berada di direktori hidrokit-nb/notebook.
drag or upload files
  • Pastikan bahwa notebook anda terunggah.
make sure file is uploaded
  • Isi deskripsi commit seperti pada gambar. Pastikan pilihan sudah seperti di gambar. Klik Commit Changes.
add commit message
  • Hasil unggah dapat dilihat dengan membuka direktori notebook.
double check file is uploaded

Pull Request

Jika notebook yang ingin diunggah sudah tersimpan pada repo Anda. Saatnya menggabungkan hasil unggahan/perubahan yang Anda lakukan dengan repo hidrokit-nb.

  • Dari halaman forked repository yang telah Anda buat klik New pull request. Alamat forked repository Anda berupa https://github.com/<username>/hidrokit-nb.
new pull request
  • Akan muncul tampilan “Comparing changes”. Klik compare accross forks untuk membandingkan repo Anda dengan repo hidrokit-nb. Pastikan repo hidrokit di posisi kiri dan repo Anda di posisi kanan (perhatikan tanda panah ⬅ yang berarti menggabungkan kanan ke kiri). Bandingkan cabang master. Klik Create Pull Request untuk ke langkah berikutnya.
comparing changes

Jika mendapatkan pesan “Can’t automatically merge”. Abaikan dan lanjut dengan klik Create Pull Request.

if something is not right
  • Isi Pull Request dengan informasi notebook Anda. Untuk judul isi sejelas dan sesingkat mungkin. Centang pilihan “Allow edit from maintainers” untuk memberikan akses pengelola mengubah PR. Klik Create Pull Request.
pull request message
  • Dari sini, pengelola akan memeriksa PR Anda. Jika terdapat konflik, pengelola akan memberi tahu langkah selanjutnya (hal ini seharusnya tidak terjadi jika ini merupakan PR pertama Anda). Jika tidak memiliki konflik, PR anda akan digabungkan ke repo hidrokit-nb dan notebook Anda akan muncul di direktori repo hidrokit-nb
you are done

🎉🎊 Selamat! Anda telah membuat Pull Request pertama Anda. 🎊🎉

Kami menanti kontribusi Anda berikutnya. 👍👍


Bacaan lebih lanjut