My First Hacktoberfest - Pengalaman Berkontribusi untuk Open Source sebagai Timer Pertama

Berkontribusi pada Open Source dan proyek-proyek dapat tampak seperti proses yang menakutkan. Mesin pencari favorit Anda akan mengembalikan banyak hasil pada panduan dan repositori untuk memulai. Tetapi berkali-kali, pencarian Anda tidak menghasilkan hasil yang Anda inginkan, Anda masih tidak tahu bagaimana berkontribusi ke Open Source bahkan setelah membaca beberapa posting blog. Reputasi yang menghambat proyek-proyek tertentu dan nada yang keras tidak membantu dan mungkin memperumit masalah lebih jauh.

Saya telah berada di sana sendiri. Saya menelusuri halaman-halaman untuk mencari repositori Open Source yang hebat untuk berkontribusi, hanya untuk memperhatikan bahwa saya tidak tahu bagaimana memulainya.

Karena frustrasi dan sedikit kecewa, saya mulai berfokus pada proyek-proyek lain.

Tapi itu semua berubah ketika saya melihat stiker Hacktoberfest sesama karyawan di laptop mereka. Saya tertarik - apakah ini sisa dari Hackathon yang lain?

Hacktoberfest ternyata sangat berbeda.

Jadi apa sebenarnya Hacktoberfest?

Petunjuk: itu tidak ada hubungannya dengan bir, peretasan, atau Oktoberfest (yang sebenarnya terjadi pada bulan September, ya!).

Hacktoberfest adalah perayaan selama sebulan untuk berkontribusi pada Open Source, berlangsung dari 1 Oktober hingga 31 Oktober. Itu diprakarsai oleh DigitalOcean bekerja sama dengan GitHub. Selama bulan Oktober Anda didorong untuk berkontribusi dan melakukan permintaan penarikan ke repositori favorit Anda di GitHub. Jika Anda berhasil membuat total empat, Anda berhak menerima T-Shirt megah seperti ini!

Keindahan T-Shirt ini adalah apa yang Anda terima setelah menyelesaikan Hacktoberfest (Kredit: @mahsinger di Twitter)

Label, label, label

Hacktoberfest terbukti menjadi bulan yang bagus untuk masuk ke Open Source. GitHub dipenuhi dengan masalah berlabel Hacktoberfest yang membutuhkan bantuan Anda. Ada cukup banyak proyek untuk dipilih - mulai dari dokumentasi hingga Python hingga RUST. Selama waktu ini, saya belajar bagaimana mencari masalah dengan label GitHub dan bagaimana menemukan masalah yang baik untuk berkontribusi.

Bagi orang-orang seperti saya, yang tidak memiliki pengalaman, label seperti first-timer-only, easy or good-first-issue terbukti menjadi teman saya. Ada juga beberapa situs web yang bagus yang bertujuan untuk mempermudah proses pencarian masalah tersebut. Misalnya, up-for-grabs.net atau kode-triase - mungkin ada banyak lagi.

Pergi dan mendaftar untuk beberapa dari ini atau lihat masalah mereka!

Belajar bagaimana berkontribusi

Ketika mencoba memberikan kontribusi pertama saya, saya menyadari bahwa hal terbesar yang tidak saya ketahui bukanlah cara menambahkan tautan ke penurunan harga atau gaya halaman. Tapi bagaimana cara membuat permintaan tarikan yang bagus menggunakan git dan baris perintah.

Saya menemukan panduan gratis Kent C. Dodds di egghead.io membantu dan mencatat perintah-perintah baris perintah yang saya jalankan sambil mengikuti.

Instruksi dapat diringkas menjadi sesuatu yang sederhana seperti ini:

// Pertama, kamu perlu mencari repositori yang ingin kamu sumbangkan dan garpu!
// Lalu kau harus mengkloning repo bercabang dua
 git clone git@github.com: yourusername / berkontribusi-repo.git
// Ubah direktori Anda ke repo baru yang Anda kloning
 cd berkontribusi-repo
// Setel repositori hulu ke repositori asli (bukan yang baru saja Anda kloning)
 git remote menambahkan upstream git@github.com: the-owners-username / berkontribusi-repo.git
// Perbarui setiap perubahan
 git ambil upstream
// Atur cabang master kami sama dengan cabang hulu
cabang git --set-upstream-to = upstream / master master
// Buat cabang baru Anda sendiri untuk permintaan tarik Anda
git checkout -b pr / my-new-cool-kontribusi
// Buat perubahan di editor teks favorit Anda dan simpan
// periksa status (harus menunjukkan file yang dimodifikasi)
status git
// lihat perubahan dan menilai kembali pekerjaan
git diff
// tambahkan perubahan apa pun ke area pementasan Anda (. untuk semua file)
git add
// Komit semua perubahan dan tambahkan pesan untuk pengelola repo
git commit -m "Saya menambahkan teks keren ini ke repositori panduan Anda"
// Dorong ke sumber repo dan buat permintaan tarik
git push asal pr / my-new-cool-kontribusi

Ini benar-benar membantu saya untuk memahami tujuan permintaan-tarik dan untuk memahami proses memberikan kontribusi. Posting blog ini juga membantu saya memahami bahwa menjadi deskriptif adalah senjata terbaik Anda - karena itu Anda dapat memperoleh dukungan dan menunjukkan apakah Permintaan Tarik masih dalam proses. Tidak lama kemudian, saya membuat kontribusi latihan lain tetapi untuk menerima T-Shirt yang saya butuhkan untuk meningkatkan permainan saya dan menemukan dua masalah lainnya.

Kecocokan yang dibuat di surga - berkontribusi pada panduan freeCodeCamp

Saya membuka Medium suatu hari dan melihat bahwa Quincy Larson telah memberikan panduan lengkap tentang bagaimana orang dapat dengan mudah berkontribusi ke repositori panduan freeCodeCamp. Sumber pengetahuan bersama di seluruh pengembangan, produk, desain, dan ilmu data. Berkontribusi pada repositori ini tidak hanya sangat dianjurkan tetapi juga sangat mudah. Anda dapat membuat kontribusi di browser Anda.

Menemukan topik tidak sulit karena repositori panduan mencakup apa pun mulai dari Aksesibilitas hingga HTML hingga Pengembangan Game.

Yang paling membuat saya penasaran adalah betapa mudahnya freeCodeCamp membuat proses untuk memungkinkan pendatang baru seperti saya memberikan kontribusi yang berarti. Berbagi pengetahuan dengan orang lain.

Anda masih belajar tentang membuat permintaan tarik, meminta kontribusi Anda digabungkan dan mematuhi standar serta panduan kontribusi. Prosesnya sedikit kurang menakutkan. Itu sempurna untuk pemula. Faktanya, adalah efisien bahwa freeCodeCamp berhasil membuat gif tentang hal itu yang meringkas proses:

Credit: freeCodeCamp - Berkontribusi pada repositori panduan freeCodeCamp

Setelah beberapa pertimbangan, saya memutuskan untuk memberikan kontribusi kecil pada distribusi Linux yang berbeda. Dan menulis bagian yang sama sekali baru tentang Pengembangan Game untuk menyelesaikan empat permintaan tarik saya. Saya membuat permainan selama musim panas sebagai bagian dari proyek disertasi saya. Menulis tentang Pengembangan Game dan alat-alat sepertinya cara yang baik untuk membagikan pengetahuan saya yang baru diperoleh dengan orang lain.

Dalam pedoman Contributing.md mereka, freeCodeCamp telah memberikan banyak detail dan cara untuk memastikan bahwa tulisan Anda singkat. Saya melakukan semua penelitian saya, mendukungnya dengan sumber dan memecatnya melalui aplikasi Hemingway. Suara aktif dan kalimat pendek untuk menang!

Saya mengajukan permintaan tarikan dan berada di atas bulan saat digabung. Umpan balik yang menggembirakan juga merupakan nilai tambah yang bagus dari komunitas freeCodeCamp.

Tarik Permintaan untuk bagian Pengembangan Game yang saya tulis untuk panduan freeCodeCamp

Apa yang bisa kita ambil dari ini?

Saya akan menyarankan Anda untuk membebaskan diri dari asumsi, bahwa Anda harus menyumbangkan kode yang sempurna dan menyeluruh pertama kali. Kontribusi pertama Anda tidak harus menjadi terobosan (atau bahkan kode tepatnya).

Pengelola proyek tahu bahwa ini mungkin merupakan kontribusi Open Source pertama Anda jika mereka menyebut masalah ini sebagai yang pertama-kali saja atau serupa. Kontribusi Anda bisa berupa memperbaiki kesalahan ejaan, menambahkan beberapa hyperlink atau proyek pembelajaran kecil. Mulai dari yang kecil hingga terbiasa dengan prosesnya.

Banyak pengelola proyek yang menyebut masalah mereka ramah untuk pemula juga dengan senang hati menjawab pertanyaan Anda dan memberikan dukungan. Jadi, jangan malu untuk meminta klarifikasi, jika Anda tidak mengerti sesuatu.

Ketika T-Shirt Hacktoberfest akhirnya tiba pada pertengahan Desember setelah dikirim jauh-jauh dari Amerika, saya merasa seperti Natal datang lebih awal. Memegangnya di tangan saya membuat saya sadar bahwa saya telah membantu menciptakan dan memperluas sesuatu yang penting. Perasaan saya percaya banyak orang yang berkontribusi pada Open Source secara teratur akan mengalami. Mengenakannya selalu mengingatkan saya untuk membagikan pengetahuan saya dan tahun ini saya juga akan mencoba dan membuat lompatan untuk berkontribusi lebih banyak kode, lagipula saya bukan pemula lagi!