README.id.md

Kontribusi Pertama

Melakukan suatu hal untuk pertama kali akan selalu terasa sulit. Terutama ketika berkolaborasi dan membuat kesalahan, akan menimbulkan rasa tidak nyaman. Namun, sumber terbuka adalah tentang berkolaborasi dan kerja sama. Kami ingin menyederhanakan cara kontributor sumber terbuka yang baru untuk mulai belajar dan berkontribusi untuk pertama kali.

Membaca artikel dan menonton tutorial memang dapat membantu, tetapi apa yang lebih baik dibandingkan dengan melakukannya langsung tanpa membuat kekacauan? Proyek ini bertujuan untuk menyediakan panduan dan menyederhanakan bagaimana para pemula dapat membuat kontribusi pertama mereka. Ingat: Semakin santai anda, maka semakin cepat anda belajar. Jika anda mencari cara untuk membuat kontribusi pertama maka cukup ikuti langkah-langkah berikut. Kami janji, ini akan menyenangkan.

Baca dalam bahasa lainnya

🇬🇧 🇮🇳 🇲🇲 🇮🇩 🇫🇷 🇪🇸 🇳🇱 🇱🇹 🇷🇺 🇸🇰 🇯🇵 🇻🇳 🇵🇱 🇮🇷 🇮🇷 🇰🇷 🇰🇵 🇩🇪 🇩🇰 🇨🇳 🇹🇼 🇬🇷 🇪🇬 🇸🇦 🇺🇦 🇧🇷 🇵🇹 🇮🇹 🇹🇭 🏴 🇵🇰 🇧🇩 🇲🇩 🇷🇴 🇹🇷 🇸🇪 🇸🇮 🇮🇱 🇨🇿 🇲🇽

Apabila belum memiliki git, install segera .

Fork repositori ini

Fork repositori ini dengan cara menekan tombol fork yang ada di bagian atas layar. Hal tersebut akan membuat salinan repositori ini di akun anda.

Klon repositori

Sekarang klon repositori ini ke komputer anda. Tekan tombol clone lalu tekan ikon "copy to clipboard".

Buka terminal dan eksekusi perintah git berikut:

git clone "url yang telah anda salin"

yang mana "url yang telah anda salin" (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 anda. Pada langkah ini anda menduplikasi konten dari repositori first-contributions di GitHub ke komputer anda.

Membuat Cabang

Ganti ke direktori repositori di komputer (jika belum ada di sana):

cd first-contributions

Buat cabang dengan perintah git checkout:

git checkout -b <add-nama>

Contoh:

git checkout -b add-alonzo-church

(Nama cabang tidak perlu mengandung kata add namun layak untuk ditambahkan karena tujuan dari cabang ini adalah menambahkan nama anda ke dalam sebuah daftar.)

Buat perubahan yang diperlukan lalu commit perubahan tersebut

Buka berkas Contributors.md menggunakan teks editor, tambahkan nama anda ke dalamnya lalu simpan 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 cabang yang sebelumnya telah dibuat menggunakan perintah git add:

git add Contributors.md

Simpan perubahan tersebut menggunakan perintah git commit:

git commit -m "Add <nama> to Contributors list"

ganti <nama> dengan nama anda.

Dorong perubahan ke GitHub

Dorong perubahan menggunakan perintah git push:

git push origin <add-nama>

Ganti <add-nama> dengan nama cabang yang sebelumnya telah dibuat.

Submit perubahan untuk diulas

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 penggabungan terhadap semua perubahan anda ke cabang master proyek ini. Anda akan mendapatkan pemberitahuan melalui email setelah perubahan tersebut selesai digabungkan.

Cabang master dari fork anda tidak akan memiliki perubahan-perubahan tersebut. Untuk membuat fork anda selaras dengan milik saya, ikuti langkah-langkah berikut.

Membuat fork anda selaras dengan repositori ini

Pertama, ganti posisi ke cabang 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 digabungkan, ambil versi baru dari repositori saya:

git fetch upstream

Di sini kita melakukan penarikan terhadap semua perubahan di fork saya (upstream remote). Sekarang, anda perlu melakukan penggabungan terhadap revisi baru dari repositori saya ke dalam cabang master milik anda.

git rebase upstream/master

Di sini anda menerapkan semua perubahan yang telah anda ambil ke cabang master. Jika anda dorong cabang 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 penggabungan terhadap cabang anda <add-nama> ke dalam cabang master dan anda telah melakukan penggabungan terhadap cabang master saya ke dalam cabang master milik anda. Cabang 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 cabang ini menunjukkan tujuan yang spesial. Masa hidupnya bisa dijadikan lebih pendek.

Ke mana lagi setelah dari sini?

Mari rayakan kontribusi anda dan bagikan pengalaman tersebut bersama teman-teman dengan pergi ke web app.

Anda dapat bergabung dengan tim slack kami jika membutuhkan bantuan atau memiliki pertanyaan. Bergabung dengan tim slack.

Sekarang, mari mulai berkontribusi di proyek lain. Kami sudah mengumpulkan daftar proyek dengan isu yang mudah dikerjakan sehingga anda dapat segera memulai. Cek di [daftar proyek web app] (https://roshanjossey.github.io/first-contributions/#project-list).

Materi tambahan

Tutorial menggunakan alat lain

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code

Promosi

Jika anda menyukai proyek ini, bintangi di GitHub. Jika anda orang yang gemar bersosial, ikuti Roshan di Twitter dan GitHub.