Sulit. Selalu sulit saat pertama kali Anda melakukan sesuatu. Terutama ketika Anda berkolaborasi, membuat kesalahan bukanlah hal yang nyaman. Kami ingin menyederhanakan cara kontributor open-source baru belajar dan berkontribusi untuk pertama kalinya.
Membaca artikel dan menonton tutorial dapat membantu, tetapi apa yang lebih baik daripada langsung mempraktikan hal-hal tersebut? Proyek ini bertujuan untuk memberikan panduan dan menyederhanakan cara memberikan kontribusi pertama bagi pemula. Jika Anda ingin memberikan kontribusi untuk pertama kalinya, ikuti langkah-langkah di bawah ini.
Jika Anda tidak nyaman dengan baris perintah, di sini ada tutorial menggunakan GUI.
Baca ini dalam bahasa lain.
๐ฎ๐ณ ๐ฒ๐ฒ ๐ฎ๐ฉ ๐ซ๐ท ๐ช๐ธ ๐ณ๐ฑ ๐ฑ๐น ๐ท๐บ ๐ง๐ฌ ๐ธ๐ฐ ๐ฏ๐ต ๐ป๐ณ ๐ต๐ฑ ๐ฎ๐ท ๐ฎ๐ท ๐ฐ๐ท ๐ฐ๐ต ๐ฉ๐ช ๐ฉ๐ฐ ๐จ๐ณ ๐น๐ผ ๐ฌ๐ท ๐ช๐ฌ ๐ธ๐ฆ ๐บ๐ฆ ๐ง๐ท ๐ต๐น ๐ฎ๐น ๐น๐ญ ๐ด ๐ณ๐ต ๐ต๐ฐ ๐ง๐ฉ ๐ฒ๐ฉ ๐ท๐ด ๐น๐ท ๐ธ๐ช ๐ฒ๐พ ๐ธ๐ฎ ๐ฎ๐ฑ ๐จ๐ฟ ๐ฒ๐ฝ ๐ต๐ญ ๐ฟ๐ฆ ๐ฟ๐ฆ ๐ฐ๐ช ๐ณ๐ฌ ๐ท๐ธ
Apabila belum memiliki git, install segera .
Fork repositori ini dengan cara menekan tombol fork yang ada di bagian kanan atas layar. Hal tersebut akan membuat salinan repositori ini di akun anda.
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
username-anda
adalah username Github Anda. Pada langkah ini, Anda menyalin konten dari repositori first-contributions di GitHub ke komputer anda.
Pindah ke direktori repositori Anda yang baru saja disalin (jika belum ada di sana):
cd first-contributions
Buat cabang dengan perintah git checkout
:
git checkout -b <add-nama-cabang-baru>
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.)
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 menggunakan perintah git push
:
git push origin <add-nama-cabang-baru>
Ganti <add-nama-cabang-baru>
dengan nama cabang yang sebelumnya telah dibuat.
Jika Anda membuka repositori Anda di GitHub, maka akan ada tombol Compare & pull request
. Tekan tombol tersebut.
Kirimkan Pull Request (PR)
Segera Saya (pengelola) akan menggabungkan semua perubahan Anda ke cabang utama dari proyek ini. Anda akan mendapatkan email notifikasi setelah perubahan digabungkan.
Selamat! Anda baru saja menyelesaikan fork -> klon -> ubah -> alur kerja Pull Request yang akan sering Anda temui sebagai kontributor!
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.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code |
--- | --- | --- | --- |
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code |