Lewati ke konten utama

Pencarian

Temukan konteks yang Anda perlukan

Terbitan terbaru

Tekan Esc untuk menutup.

Software Panduan Sumber resmi / primer

Panduan GitHub untuk Pemula: Repository, Branch, Commit, dan Pull Request tanpa Bingung

Belajar GitHub lebih mudah jika memahami alur perubahan, bukan menghafal perintah. Panduan ini mencakup keamanan akun, repo, branch, commit, pull request, review, dan recovery.

Diskusi
Jaringan lain
Alur GitHub pemula dari working directory ke commit, branch, pull request, review, dan merge

GitHub merangkum seri pemulanya menjadi roadmap dari version control hingga kontribusi open source. Kunci belajar bukan menghafal semua command, melainkan memahami tiga tempat kerja Git: working directory, staging area, dan repository lokal; kemudian alur branch, commit, push, pull request, review, serta merge. Pemula juga perlu mengaktifkan 2FA, menyimpan recovery code, menjaga secret dari repository, dan mempraktikkan recovery agar Git menjadi jaring pengaman, bukan sumber ketakutan.

Mulai dari model perubahan, bukan daftar command

Working directory adalah file yang sedang diedit. Staging area memilih perubahan yang masuk snapshot berikutnya, sedangkan repository lokal menyimpan commit. Git status menunjukkan perbedaan di antara ketiganya. Git add memindahkan pilihan ke staging, dan git commit menyimpan snapshot beserta pesan. Memahami alur ini lebih penting daripada menyalin command secara buta.

Commit bukan tombol save biasa. Buat satu perubahan logis dengan pesan yang menjelaskan tujuan, bukan hanya nama file. Periksa diff sebelum commit agar secret, output build, atau file besar tidak ikut. Jika banyak perubahan bercampur, stage file atau hunk secara selektif. History yang kecil dan fokus memudahkan review serta rollback.

  • Gunakan status sebelum dan sesudah staging.
  • Periksa diff yang akan di-commit.
  • Satu commit sebaiknya menjawab satu tujuan.
  • Jangan masukkan password, key, atau database dump.

Amankan akun dan siapkan repository

GitHub menyarankan 2FA karena password dapat dicuri atau dipakai ulang. Simpan recovery code di password manager yang terpisah dari perangkat utama. Periksa email, SSH key, personal access token, OAuth app, dan session secara berkala. Untuk organisasi, gunakan akses minimum serta cabut credential anggota yang sudah pergi.

Saat membuat repository, tentukan public atau private dengan sadar. README menjelaskan tujuan, cara menjalankan, dan status project. Gitignore mengecualikan dependency, file editor, cache, environment, serta output build. License menjelaskan hak penggunaan pada repository publik. Jangan menganggap private berarti aman dari secret leak; history tetap dapat disalin oleh siapa pun yang memiliki akses.

  • Aktifkan 2FA dan simpan recovery codes.
  • Tambahkan README, gitignore, serta license yang sesuai.
  • Gunakan secret manager untuk credential.
  • Audit collaborator dan token secara berkala.

Branch memisahkan pekerjaan dari baseline

GitHub flow memakai branch untuk mengisolasi perubahan dari main. Ambil baseline terbaru, buat branch dengan nama deskriptif, lalu commit pekerjaan dalam scope kecil. Push mengirim commit lokal ke remote; pull mengambil perubahan terbaru. Sebelum membuka pull request, sinkronkan branch serta selesaikan conflict dengan memahami kedua sisi, bukan memilih semua dari satu versi.

Branch tidak menggantikan komunikasi. Satu nama seperti fix-login-timeout memberi konteks, tetapi issue dan deskripsi menjelaskan requirement serta acceptance criteria. Hindari branch hidup berbulan-bulan karena semakin jauh dari main. Untuk eksperimen yang gagal, branch dapat dihapus tanpa mengotori baseline. Kemampuan membuang perubahan adalah bagian penting workflow sehat.

Pull request adalah proposal dan ruang review

Pull request menampilkan diff serta tempat berdiskusi sebelum perubahan digabung. Tulis judul yang spesifik, ringkasan masalah, pendekatan, cara menguji, screenshot bila visual, risiko, serta rollback. Review sendiri lebih dulu untuk menemukan debug log, typo, atau file tidak sengaja. PR kecil cenderung lebih cepat dipahami dan lebih mudah di-revert.

Reviewer perlu menilai requirement, correctness, keamanan, desain, test, dan operability, bukan sekadar style. Jawab komentar dengan perubahan atau alasan. Jangan resolve diskusi sebelum isu benar-benar selesai. CI membantu menjalankan test dan lint, tetapi status hijau tidak menjamin produk benar. Setelah merge, pantau hasil deployment serta hapus branch yang tidak dibutuhkan.

  • Hubungkan issue dan jelaskan cara verifikasi.
  • Lampirkan evidence untuk perubahan visual atau performa.
  • Pisahkan komentar blocking dari saran.
  • Gunakan approval serta branch protection untuk main.

Latihan satu jam yang membangun mental model

Buat repository latihan berisi README. Clone, buat branch, ubah satu paragraf, periksa status serta diff, commit, push, dan buka pull request. Minta teman memberi komentar atau review sendiri dari browser. Edit baris yang sama pada branch lain untuk mempelajari merge conflict, lalu selesaikan dengan membaca hasil final sebelum commit.

TenFourSeven menyarankan menutup latihan dengan recovery: batalkan perubahan working tree yang belum dibutuhkan, buat revert untuk commit yang sudah masuk, dan pulihkan file dari history tanpa reset destruktif. Catat command yang dipakai beserta efeknya. Tujuan latihan bukan bergerak cepat, melainkan mengetahui di mana perubahan berada dan cara kembali ke kondisi aman.

  • Latih branch-commit-push-PR-merge.
  • Ciptakan merge conflict yang aman.
  • Praktikkan revert dan restore.
  • Baca history serta blame tanpa menyalahkan orang.

GitHub menjadi mudah ketika pemula memahami perjalanan perubahan dari working directory menuju staging, commit, branch, pull request, review, dan merge. Amankan akun dengan 2FA, jaga secret, buat commit kecil, dan tulis PR yang dapat diuji. CI serta review melindungi main, tetapi recovery tetap harus dilatih. Jangan mengejar hafalan command; bangun mental model yang menjelaskan posisi perubahan, siapa yang meninjaunya, dan bagaimana kembali bila hasil tidak sesuai.

Iklan