Berkontribusi melalui Github

Prasyarat

Untuk dapat berkontribusi melalui pull request, ada beberapa prasyarat:

Tahu cara menggunakan minimal Git
Memiliki akun Github
Miliki cabang proyek yang ingin Anda sumbangkan

Sebelum masuk ke perincian, penting untuk membuat titik kecil pada kosakata. Berikut adalah glosarium kecil dari kata-kata yang selalu kami gunakan dengan Git/Github:

repo: Singkatan dari "Repositori". Kami menggunakan kata ini untuk menunjuk sekumpulan file yang diversi dengan Git.
cabang: Ini adalah cabang dalam proyek Git. Cabang memungkinkan Anda membuat versi kode paralel di beberapa titik dalam sejarah.
master: Menunjuk cabang utama dari repo.
asal: Menunjuk repo jarak jauh. Dihosting di Github, misalnya.
pull request: Ini adalah operasi yang memungkinkan Anda mengusulkan modifikasi kode ke proyek di Github.
garpu: Ini adalah repo yang merupakan salinan dari repo lain. Ini memungkinkan Anda untuk memulai dari proyek yang sudah ada untuk memodifikasinya, memperbaikinya, memperbaikinya, atau melakukan sesuatu yang lain dengannya.
upstream: Dalam hal fork, tentukan repo dari mana fork tersebut berasal.
ambil: Ini adalah operasi yang terdiri dari pengambilan data dari jarak jauh secara lokal.
push: Ini adalah operasi yang memungkinkan data lokal dikirim ke remote.

Konfigurasi

Garpu

Hal pertama yang harus dilakukan adalah pergi ke Github, untuk membuat garpu proyek yang ingin Anda sumbangkan.

Misalnya, untuk berkontribusi pada klien Leek Wars, buka di sini: Klien Leek Wars

Kemudian, klik saja tombol "garpu" di kanan atas.

Dengan "mempercabangkan" proyek, Github akan membuat repo baru di akun Anda. Ini akan menjadi salinan dari proyek asli.

Kemudian dapatkan alamat repo github Anda, melalui alamat url, atau dengan mengklik tombol hijau "Kloning atau unduh".

Pergi ke lokasi tempat Anda ingin menempatkan repo lokal Anda dan gunakan perintah: git clone \ Jangan lupa ganti "\".

Jadi. Anda telah membuat garpu proyek dan mengambilnya secara lokal, di mesin Anda. Namun ada satu hal lagi yang harus dilakukan untuk dapat terus menggunakannya tanpa rasa khawatir di kemudian hari.

Hulu

Anda kemudian harus mengonfigurasi upstream, yang akan memungkinkan Anda memperbarui repo dari project.

Perintah git remote -v memungkinkan Anda membuat daftar alamat jarak jauh yang dikonfigurasi.

asal https://github.com/NAMA_USER ANDA/FORK_ANDA.git (ambil) asal https://github.com/NAMA_USER ANDA/FORK_ANDA.git (push)

Untuk saat ini, Anda akan melihat dua alamat yang dikonfigurasi sebagai origin. One in fetch, saat Anda ingin memulangkan fitur baru dari jarak jauh, repo Anda dihosting di Github. Dan yang lainnya di push yang, sebaliknya, memungkinkan Anda mengirim berita lokal Anda ke repo jarak jauh.

Untuk ini, kami akan menambahkan upstream. Untuk melakukan ini, dapatkan alamat proyek yang baru saja Anda buat. Selalu melalui url, atau tombol "Clone or download".

Perintah untuk menambahkan upstream adalah: git remote add upstream \

Jika Anda menjalankan perintah git remote -v lagi, Anda akan melihat empat entri. Dua untuk origin dan dua untuk upstream. Masing-masing digandakan menjadi fetch dan push.

asal https://github.com/NAMA_USER ANDA/FORK_ANDA.git (ambil) asal https://github.com/NAMA_USER ANDA/FORK_ANDA.git (push) hulu https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (ambil) hulu https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)

Anda siap berkontribusi sekarang!

Terus up to date

(Langkah tidak diperlukan jika Anda hanya fork.)

Kemungkinannya adalah proyek yang Anda kontribusikan tidak diatur dengan pasti. Orang yang merawatnya akan membuatnya berkembang. Kontribusi lain berpotensi diterima.

Oleh karena itu, repo Anda dapat dengan cepat menjadi usang. Dan itu bisa menjadi masalah.

Jika awalnya sebuah file berisi "A", dan Anda ingin mengirimkan kontribusi untuk mengubah "A" ini menjadi "B". Sementara itu, mungkin orang lain akan melakukan perubahan dari "A" ini menjadi "C".

Dan ketika Anda mengusulkan modifikasi Anda, akan ada konflik. Tidak dapat mengubah "A" menjadi "B" karena "A" tidak lagi ada di file.

Singkatnya, penting untuk selalu memperbarui repo untuk menghindari kejutan yang tidak menyenangkan.

Jangan khawatir, karena sekarang Anda telah mengonfigurasi upstream, itu akan sangat mudah!

Hal pertama yang harus dilakukan adalah mendapatkan m baru