Proyek ini memiliki tujuan yaitu untuk menyederhanakan dan membimbing pemula untuk membuat kontribusi pertamanya di Github. Jika Anda ingin membuat kontribusi pertamamu, ikuti langkah-langkah berikut.
Jika Anda tidak terbiasa dengan baris perintah(command line), di sini ada tutorial untuk menggunakan GUI(antarmuka bergrafis).
Apabila Anda belum menginstall git di komputer Anda, install segera .
Fork repositori ini dengan cara klik tombol fork yang ada di bagian atas kanan pada halaman ini. Hal Ini akan membuat sebuah salinan repositori di akun Anda.
Sekarang kloning repositori yang sudah Anda fork ke komputer Anda. Pergi ke akun GitHub Anda, buka repositori yang sudah Anda fork, klik tombol Code dan kemudian klik ikon salin ke papan klip.
Buka sebuah terminal dan jalankan perintah git berikut:
git clone "url yang telah disalin"
bagian "url yang telah disalin" (tanpa tanda petik) adalah url ke repositori ini (proyek yang telah Anda fork ini). Lihat langkah sebelumnya untuk mendapatkan url.
Sebagai contoh:
git clone https://github.com/ini-adalah-anda/first-contributions.git
bagian ini-adalah-anda
adalah username GitHub Anda. Di sini Anda menyalin konten dari repositori first-contributions di GitHub ke komputer Anda.
Pindah ke direktori repositori yang terdapat pada komputer Anda (jika Anda belum berada di sana):
cd first-contributions
Sekarang buatlah sebuah branch menggunakan perintah git checkout
:
git checkout -b <tambahkan-nama-branch-baru>
Sebagai contoh:
git checkout -b add-alonzo-church
Sekarang buka berkas Contributors.md
menggunakan teks editor, tambahkan nama Anda ke dalamnya. Jangan menambahkan pada awal atau akhir dari berkas. Simpan dimana saja di antaranya. Sekarang simpan berkasnya.
Jika Anda pergi ke direktori proyek dan mengeksekusi perintah git status
, Anda akan melihat ada sebuah perubahan.
Tambahkan perubahan tersebut ke branch yang baru saja Anda buat menggunakan perintah git add
:
git add Contributors.md
Sekarang simpan perubahan tersebut menggunakan perintah git commit
:
git commit -m "Add <nama-anda> to Contributors list"
Ubah bagian <nama-anda>
dengan nama Anda.
Push perubahan menggunakan perintah git push
:
git push origin <tambahkan-nama-cabang-baru>
ganti bagian <tambahkan-nama-cabang-baru>
dengan nama cabang yang sebelumnya Anda buat.
Jika Anda mendapatkan kesalahan saat melakukan push, klik disini:
-
remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead. remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information. fatal: Authentication failed for 'https://github.com//first-contributions.git/'
Buka GitHub's tutorial untuk menghasilkan dan mengkonfigurasi sebuah kunci SSH ke akun Anda.
Jika Anda membuka repositori Anda di GitHub, Anda akan melihat sebuah tombol Compare & pull request
. Tekan tombol tersebut.
Sekarang kirimkan Pull Request
Saya (pengelola) akan segera menggabungkan semua perubahan Anda ke cabang utama (main branch) dari proyek ini. Anda akan mendapatkan email pemberitahuan setelah perubahan digabungkan.
Selamat! Anda baru saja menyelesaikan standar fork -> clone -> edit -> pull request sebuah alur kerja yang akan sering Anda temui sebagai seorang kontributor!
Rayakan kontribusi Anda dan bagikan dengan teman-teman dan pengikut Anda dengan membuka web app.
Anda dapat bergabung dengan tim slack kami jika Anda membutuhkan bantuan atau memiliki pertanyaan. Bergabung dengan tim slack.
Sekarang mari kita mulai dengan berkontribusi di proyek lain. Kami sudah menyusun daftar proyek dengan isu yang mudah dikerjakan sehingga Anda dapat segera memulai. Cek di daftar proyek web app.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |