Dokumentasi Git

Perjalanan Course ini sengaja sering menautkan tiap perintah ke halaman dokumentasinya — karena di dunia nyata, dokumentasi resmi adalah tempat kita kembali berulang kali: saat lupa urutan flag, saat output berbeda dari dugaan, atau saat menjumpai perilaku yang belum pernah terlihat. Kabar baiknya, seluruh pengetahuan Git yang resmi terkumpul rapi di beberapa tempat yang saling terhubung. Chapter ini memetakan tempat-tempat itu — halaman manual per perintah, buku Pro Git yang gratis, tutorial ringkas, sampai manual yang terpasang di terminal — lalu menutupnya dengan cara membaca yang efektif supaya kita tidak tenggelam di halaman berbahasa Inggris yang panjang.

Pusat Semuanya: git-scm.com/doc #

Satu alamat menjadi gerbang masuk: git-scm.com/doc . Halaman itu menghubungkan seluruh sumber resmi — reference manual, buku Pro Git, video, dan tutorial — dalam satu daftar. Menandai alamat ini di bookmark adalah investasi murah: dari sinilah semua penelusuran dokumentasi dimulai.

Reference Manual per Perintah #

Setiap perintah Git punya halaman manual sendiri dengan pola alamat git-scm.com/docs/<perintah> — misalnya git-scm.com/docs/git-commit atau git-scm.com/docs/git-config. Struktur halamannya konsisten, dan mengenali kerangkanya membuat kita tahu ke mana melompat. Halaman git commit misalnya, tersusun atas bagian-bagian ini: NAME (nama dan ringkasan satu baris), SYNOPSIS (bentuk perintah lengkap beserta opsinya — kurung siku berarti opsional, garis tegak berarti pilihan alternatif), DESCRIPTION (perilaku perintah dalam narasi), OPTIONS (daftar flag dengan penjelasan), EXAMPLES (contoh pemakaian nyata), lalu bagian spesifik perintah — halaman git commit misalnya menambah Date Formats dan Hooks — dan ditutup SEE ALSO yang menautkan topik terkait. Isi halaman-halaman ini identik dengan manual yang terpasang di terminal; keduanya lahir dari sumber yang sama, hanya medianya berbeda.

Buku Pro Git #

Pro Git adalah buku resmi Git edisi kedua — utuh, gratis, dan terbit di git-scm.com/book . Sepuluh babnya menyusun jalur belajar dari fondasi sampai isi perut Git:

Bab 2 sampai 7 adalah lanjutan alami Course ini — bab 7 khususnya menghimpun alat yang belum sempat kita bahas tuntas. Bonus bagi kita: edisi bahasa Indonesia tersedia lengkap di git-scm.com/book/ms/v2, misalnya halaman Working with Remotes yang membahas remote dalam bahasa yang kita pakai sehari-hari.

Tutorial Resmi yang Ringkas #

Dua dokumen pendek resmi menemani buku: gittutorial mengantarkan pemula baru dalam lima belas menit ke siklus commit dasar, sedangkan giteveryday — yang sudah kita singgung di contekan perintah — merangkum perintah minimum yang berguna tiap hari, dikelompokkan per peran: individu, kontributor, integrator, hingga administrator. Keduanya juga bisa dibuka dari terminal sebagai concept guide — daftar lengkap panduan konsep yang terpasang bersama Git:

git help -g

Output yang Dihasilkan:

The Git concept guides are:
   core-tutorial    A Git core tutorial for developers
   credentials      Providing usernames and passwords to Git
   cvs-migration    Git for CVS users
   diffcore         Tweaking diff output
   everyday         A useful minimum set of commands for Everyday Git
   faq              Frequently asked questions about using Git
   glossary         A Git Glossary
   namespaces       Git namespaces
   remote-helpers   Helper programs to interact with remote repositories
   submodules       Mounting one repository inside another
   tutorial         A tutorial introduction to Git
   tutorial-2       A tutorial introduction to Git: part two
   workflows        An overview of recommended workflows with Git

Perhatikan entri glossary di daftar itu — panduan istilah resmi yang menjadi subjek chapter berikutnya.

Manual dari Terminal #

Seluruh halaman manual juga bisa dibuka tanpa internet lewat git help <perintah> — mekanisme lengkapnya, termasuk cara membaca baris SYNOPSIS dan daftar seluruh perintah lewat git help -a, sudah kita bahas di chapter git help . Satu catatan jujur dari mesin latihan Course tercatat di sana: kontainer minimal tanpa program man membuat git help <perintah> gagal membuka halaman — di komputer lengkap, Linux, macOS, maupun Git Bash, perintah yang sama membuka manual di pager.

Cara Membaca Secara Efektif #

Strategi membaca halaman manual tanpa tenggelam: mulai dari NAME untuk memastikan perintah yang tepat, baca SYNOPSIS untuk memahami bentuk argumennya, lompat ke EXAMPLES untuk contoh pemakaian yang paling mendekati kasus kita, dan baru menyelam ke OPTIONS untuk flag yang belum jelas. Tabel ringkas ke mana melompat sesuai kebutuhan:

Satu hambatan terakhir untuk pembaca Indonesia: halaman manual memakai kosakata teknis resmi — index, ref, porcelain, plumbing — yang tidak selalu sama dengan istilah akrab yang dipakai Course ini. Untuk itulah Git menyediakan glosarium resmi, dan memetakannya ke kosakata Course adalah pekerjaan chapter berikutnya. Lanjut ke Glosarium Git Resmi .