Melakukan suatu hal untuk pertama kali akan selalu terasa sulit. Terutama apabila berkolaborasi dimana membuat kesalahan akan menimbulkan rasa tidak nyaman. Namun, open source adalah tentang berkolaborasi dan kerja sama. Kami ingin mensederhanakan cara kontributor open-source baru untuk belajar dan berkontribusi untuk pertama kali
Membaca artikel dan menonton tutorial dapat membantu, tetapi apa yang lebih baik dibandingkan dengan melakukannya langsung tanpa membuat kekacauan? Proyek ini bertujuan untuk menyediakan panduan dan mensederhanakan bagaimana para pemula dapat membuat kontribusi pertama mereka. Ingat: Semakin santai anda, maka semakin cepat belajar. Jika anda mencari cara untuk membuat kontribusi pertama maka cukup ikuti langkah-langkah berikut. Kami berjanji, ini akan menyenangkan.
Read this in other languages: English, Spanish, Dutch, Hindi, Russian, Japanese, Vietnamese, Polish, Korean, German, Simplified Chinese, Traditional Chinese, Greek, العربية.
Apabila belum memiliki git, install .
Fork repositori ini dengan cara menekan tombol fork yang ada di bagian atas layar. Hal tersebut akan membuat copy repositori ini di akun anda.
Sekarang clone repositori ini ke komputer anda. Tekan tombol clone lalu tekan icon "copy to clipboard".
Buka terminal dan eksekusi perintah git berikut:
git clone "url yang telah anda copy"
where "url yang telah anda copy" (tanpa tanda petik) adalah url ke repositori ini. Lihat langkah sebelumnya untuk mendapatkan url.
Contoh:
git clone https://github.com/username-anda/first-contributions.git
Dimana username-anda adalah username Github. Pada langkah ini anda menduplikasi konten dari repositori first-contributions di GitHub ke komputer anda.
Ganti ke direktori repositori di komputer (jika belum ada di di sana):
cd first-contributions
Buat branch dengan perintah git checkout:
git checkout -b <add-nama>
Contoh:
git checkout -b add-alonzo-church
(Nama branch tidak perlu mengandung kata add namun layak untuk ditambahkan karena tujuan dari branch ini adalah menambahkan nama anda ke dalam sebuah daftar.)
Buka berkas Contributors.md menggunakan text editor, tambahkan nama anda ke dalamnya lalu save berkas tersebut. Apabila anda masuk ke direktori dan mengeksekusi perintah git status maka anda dapat melihat bahwa telah ada perubahan. Tambahkan perubahan tersebut ke dalam branch yang sebelumnya telah dibuat menggunakan perintah git add:
git add Contributors.md
Commit perubahan tersebut menggunakan perintah git commit:
git commit -m "Add <nama> to Contributors list"
ganti <nama> dengan nama anda.
Push perubahan menggunakan perintah git push:
git push origin <add-nama>
Ganti <add-nama> dengan nama branch yang sebelumnya telah dibuat.
Jika anda membuka repositori anda di GitHub, maka akan ada tombol Compare & pull request. Tekan tombol tersebut.
Submit pull request.
Suatu saat nanti saya akan melakukan merge terhadap semua perubahan anda ke master branch proyek ini. Anda akan mendapatkan email notifikasi setelah perubahan tersebut selesai di-merge.
Branch master dari fork anda tidak akan memiliki perubahan-perubahan tersebut. Untuk membuat fork anda selaras dengan milik saya, ikuti langkah-langkah berikut.
Pertama, ganti posisi ke branch master.
git checkout master
Tambahkan url repo saya sebagai upstream remote url:
git remote add upstream https://github.com/Roshanjossey/first-contributions
Hal ini untuk memberitahu git bahwa ada versi lain dari proyek ini di url yang telah dispesifikasikan dan disebut sebagai upstream. Apabila perubahan telah di-merge, fetch versi baru dari repositori saya:
git fetch upstream
Di sini kita melakukan fetch terhadap semua perubahan di fork saya (upstream remote). Sekarang, anda perlu melakukan merge terhadap revisi baru dari repositori saya ke dalam branch master milik anda.
git rebase upstream/master
Di sini anda menerapkan semua perubahan yang telah anda fetch ke branch master. Jika anda push branch master sekarang, fork anda juga akan memiliki perubahan:
git push origin master
Perhatikan bahwa di sini anda melakukan push ke remote bernama origin.
Pada titik ini saya telah melakukan merge terhadap branch anda <add-nama> ke dalam branch master dan anda telah melakukan merge terhadap branch master saya ke dalam branch master milik anda. Branch milik anda sudah tidak dibutuhkan lagi sehingga bisa anda hapus:
git branch -d <add-nama>
dan anda dapat menghapus versi tersebut yang ada di repositori remote:
git push origin --delete <add-nama>
Hal ini sebenarnya tidak diperlukan namun nama dari branch ini menunjukan tujuan yang spesial. Masa hidupnya bisa dijadikan pendek
 |
 |
 |
|---|---|---|
| GitHub Desktop | Visual Studio 2017 | GitKraken |
Anda dapat bergabung dengan tim slack kami jika membutuhkan bantuan atau memiliki pertanyaan. Bergabung dengan tim slack
Berikut adalah beberapa isu level pemula di repositori populer yang dapat anda kerjakan. Silahkan kunjungi repositori-repositori tersebut untuk belajar lebih lanjut.
