GitHub

#git #github #version-control #programming #tutorial #guide

GitHub adalah layanan hosting untuk repository Git dan tempat orang membangun software bersama.

Apa itu GitHub

GitHub menyediakan tempat menyimpan repo, membahas pekerjaan lewat issue, mengisolasi eksperimen lewat branch, dan menggabungkan kontribusi lewat pull request. Platform ini juga menjalankan komunitas developer besar dan menyimpan riwayat lengkap setiap perubahan.

Untuk Hello World Anda tidak perlu install Git atau pakai command line. Cukup akun GitHub, semua langkah bisa lewat web.

Hello World: alur 5 langkah

Dokumen Hello World mengajarkan konsep repo, branch, commit, dan pull request dalam satu latihan.

Langkah 1: Buat repository

Repo seperti folder proyek yang berisi file, gambar, video, atau folder lain. Biasanya ada README.md berisi informasi proyek dalam Markdown, bahasa formatting yang mudah dibaca dan ditulis.

Via web:

  1. Di sudut kanan atas halaman mana pun, buka menu lalu klik New repository.
  2. Isi Repository name hello-world dan Description singkat seperti "This repository is for practicing the GitHub Flow".
  3. Pilih Public atau Private.
  4. Centang Add a README file.
  5. Klik Create repository.

Repo hello-world ini bisa jadi tempat menyimpan ide, resource, atau diskusi. Opsi license ada, tetapi tidak wajib untuk latihan.

Langkah 2: Buat branch

Secara default repo punya branch main sebagai versi definitif. Branch lain adalah snapshot main saat dibuat. Perubahan di branch tidak muncul di main sampai di-merge, sehingga aman untuk eksperimen. Jika main berubah saat Anda bekerja di branch, Anda bisa pull update tersebut.

Cara membuat readme-edits:

  1. Buka tab Code di repo hello-world.
  2. Klik dropdown yang bertuliskan main di atas daftar file.
  3. Ketik readme-edits.
  4. Klik Create branch: readme-edits from main.

Sekarang ada main dan readme-edits dengan isi yang sama pada awalnya. Diagram di docs menunjukkan feature yang bercabang dari main, melalui Commit changes, Submit pull request, dan Discuss proposed changes, lalu merge kembali.

Langkah 3: Buat dan commit perubahan

Commit adalah perubahan yang disimpan dengan pesan yang menjelaskan alasan. Pesan ini membantu orang lain memahami apa dan mengapa.

  1. Di branch readme-edits, klik file README.md.
  2. Klik ikon pensil untuk edit.
  3. Tulis sedikit tentang diri Anda.
  4. Klik Commit changes, tulis commit message, lalu Commit changes lagi.

Perubahan hanya ada di readme-edits, belum di main.

Langkah 4: Buka pull request

Pull request adalah inti kolaborasi di GitHub. Anda mengusulkan perubahan, meminta review, dan menampilkan diff dengan warna berbeda untuk tambahan dan penghapusan. PR bisa dibuka segera setelah commit, bahkan sebelum kode selesai.

  1. Klik tab Pull requests.
  2. Klik New pull request.
  3. Di Example Comparisons, pilih readme-edits untuk dibandingkan dengan main.
  4. Periksa diff di halaman Compare.
  5. Klik Create pull request, beri judul dan deskripsi singkat. Anda bisa pakai emoji dan drag and drop gambar atau gif.
  6. Klik Create pull request lagi.

Saat berkolaborasi dengan orang lain, di titik ini Anda meminta review. Kolaborator bisa komentar atau mengusulkan perubahan sebelum merge.

Langkah 5: Merge pull request

Merge menggabungkan readme-edits ke main. Jika ada konflik dengan kode di main, GitHub akan mencegah merge sampai konflik diselesaikan lewat commit perbaikan atau diskusi di PR. Pada walkthrough ini tidak ada konflik.

  1. Di bawah pull request, klik Merge pull request.
  2. Klik Confirm merge. Anda mendapat pesan berhasil dan request tertutup.
  3. Klik Delete branch. Setelah merge, perubahan sudah di main, branch bisa dihapus dengan aman. Untuk perubahan berikutnya buat branch baru dan ulangi proses.
  4. Kembali ke tab Code untuk melihat perubahan di main.

Setelah selesai, cek contribution graph di profil. Untuk latihan lagi, coba kursus GitHub Skills "Introduction to GitHub". Langkah selanjutnya adalah personalisasi profil dan Markdown, dibahas di Managing your profile README.

Cerita How GitHub works: issue ke merge

Video 3 menit dari channel GitHub memakai cerita traktor Harvester L700 untuk menjelaskan alur yang sama.

Eddie, yang bekerja di lapangan dengan traktor, punya ide berbagi data diagnostik sensor untuk meningkatkan panen. Ia membuka issue di GitHub. Issue adalah thread diskusi tempat orang melaporkan bug, meminta fitur, atau bertanya. Sam melihat issue itu dan menugaskan Vijay.

Vijay butuh tempat eksperimen yang tidak langsung sampai ke ladang, jadi ia membuat branch sebagai alternate timeline. Traktor lain di seluruh dunia tetap berjalan mengumpulkan moisture data tanpa terganggu.

GitHub melacak perubahan Vijay dan menyimpan snapshot progres. Ketika siap, Vijay membuka pull request untuk menunjukkan perubahan kepada tim. Rekan bisa membantu mengatasi hambatan dan menambah perbaikan langsung ke branch yang sama, seperti Melinda yang menambahkan commit. Semua kontribusi dan feedback tercatat di pull request, termasuk pesan dari sistem lain.

Setelah tim menyetujui, Vijay melakukan merge. Fitur baru langsung tersedia untuk semua petani. Video menutup dengan pesan bahwa GitHub adalah komunitas developer besar dan ide seperti milik Eddie bisa dipakai jauh di luar dugaan, entah oleh engineer, code enthusiast, atau petani.

GitHub Skills dan Learn

Setelah Hello World, langkah yang disarankan adalah kursus interaktif di skills.github.com, sekarang bernama GitHub Learn. Skills memakai repository template dan workflow Actions yang otomatis memajukan langkah saat Anda push atau trigger event.

Konten Skills mengikuti model yang sama: header berisi judul, gambar, dan deskripsi singkat yang menjawab mengapa kursus ini diambil. Start step menjelaskan tujuan, siapa target, apa yang dipelajari dan dibangun, prereq, serta durasi dan cara memulai. Workflow steps berjumlah 3 sampai 5, format konsisten: akui penyelesaian langkah sebelumnya dengan emphasis, jelaskan konsep dengan link ke docs, beri aktivitas ### :keyboard: Activity: dan ordered list tugas, serta catat butuh sekitar 20 detik dan refresh untuk maju. Finish step merayakan penyelesaian, merekap apa yang dibuat, memberi next steps, dan gambar perayaan. Footer selalu ada, berisi bantuan, status page, license, dan Code of Conduct.

File di .github/steps/ menyimpan konten per step, dan .github/workflows/ menyimpan workflow bernama N-brief-summary.yml. Setiap workflow berisi header komentar, trigger event seperti on: push branches: [main] dan workflow_dispatch, job dengan runs-on: ubuntu-latest dan kondisi if: !github.event.repository.is_template, serta steps actions/checkout dan skills/action-update-step yang memindahkan from_step ke to_step.

Penulis kursus sebaiknya kenal Markdown, YAML, dan GitHub Actions, ditambah GitHub CLI bila perlu. Perencanaan kursus: tulis learning goal, outline 3 sampai 5 step yang bisa selesai 30 sampai 45 menit, dan pertimbangkan bahwa learner butuh waktu sekitar empat kali expert. Jika kursus panjang, pecah menjadi beberapa kursus. Selama setup, gunakan template, centang Template repository karena Actions mati di fork, tambah social image 1280x640, aktifkan auto-delete head branches, tambah LICENSE dan .gitignore, dan masukkan topik skills-course.

Bagian testing dan best practices menekankan komentar yang banyak, simpan semua di satu repo, dan jaga format tetap konsisten.

Praktik yang disarankan

Tautan dan kelanjutan

Lihat juga

Enter your search text in the box above

Select a result to preview