βDiscussion is welcome. Judgement is notβ
π Terima kasih sebelumnya dalam mempertimbangkan untuk berkontribusi di proyek hidrokit. hidrokit memerlukan bantuan dari Anda. Anda dapat berkontribusi dalam berbagai bentuk berupa ide, keahlian teknis, koreksi, diskusi, dan apapun yang menurut Anda bisa memajukan dan mengembangkan proyek ini.
Sebelumnya, kami harap setiap individu dalam komunitas ini mengikuti kode etik yang berlaku. Mari buat lingkungan yang nyaman, bersahabat, dan kondusif dalam pengembangan proyek ini. Mari belajar bersama dari satu sama lain dalam membangun proyek ini.
Daftar isi
- Siapapun bisa berkontribusi
- Roadmap
- Kategori Kontribusi
- Issue dan Pull request
- Aturan
- Yang perlu Anda ketahui
Siapapun bisa berkontribusi
Kontribusi di hidrokit tidak selalu berbentuk implementasi kode. Kontribusi dapat berupa menulis panduan (dokumentasi), mengajukan ide, ikut berdiskusi, mengusulkan fitur baru, memperbaiki tata cara penulisan, memperbaiki kode yang sudah ada, dll. Sehingga proyek ini terbuka untuk siapapun dengan latar belakang apapun.
Halaman How to Contribute to Open Source menjelaskan secara umum dan detail apa saja yang bisa kamu kontribusikan dalam proyek open-source dan manfaatnya bagi Anda.
Anda juga bisa menganggap proyek ini sebagai latihan Anda atau langkah awal dalam memulai kontribusi di proyek open source demi membangun kepercayaan diri, mengasah berkomunikasi dan keahlian Anda, dan berbagi hasil karya Anda.
Roadmap
Untuk memantau status pengembangan hidrokit, Anda bisa melihatnya pada halaman isu di github atau halaman project github.
Kategori Kontribusi
Kami membagi kontribusi menjadi empat kategori utama yaitu:
- Dokumentasi: koreksi dokumentasi, penerjemahan, penulisan/pengejaan, komunikasi, dan kerapihan, dll. Bertujuan untuk memudahkan pengguna dalam menggunakan produk.
- Situs: pengembangan situs, koreksi penulisan/pengejaan, penambahan konten, memperbagus situs, dll. Bertujuan memudahkan pengguna mencari informasi melalui situs.
- Hidrologi: mengusulkan ide pemodelan/metode, mengoreksi/memperjelas teori, dll. Bertujuan membahas aspek hidrologi/keairan/sumberdaya air dalam proyek.
- Python: testing, koreksi implementasi kode, dll. Bertujuan membahas aspek implementasi kode/pemrograman dalam proyek.
Untuk panduan berkontribusi yang lebih detail bisa mengunjungi halamannya masing-masing.
Issue dan Pull request
Ada dua istilah yang akan sering digunakan dalam proyek ini yaitu isu (issue) dan pull request (PR) saat berbicara berkontribusi. Isu bisa dibilang seperti tiket, yang dibuat untuk membahas suatu ide/masalah. Ketika isu dibuat, orang lain bisa melihat isu Anda. Jika ada kontributor yang tertarik mengatasi isu Anda, kontributor akan forking repo utama dan mulai mengubah kode/data untuk menyelesaikan isu Anda. Setelah kontributor selesai dengan perubahannya, kontributor akan meminta pull request atau PR untuk menggabungkan hasil kerjaan kontributor ke repo utama. Ilustrasi proses ini bisa dilihat di video berikut:
Langsung ada ide? π Buruan buat isu / pull request sebelum idenya terbang. πΈπΈ οΈ
Segala bentuk komunikasi harus mengikuti kode etik yang berlaku.
Kami menyarankan mengikuti beberapa saran berikut ini saat berkomunikasi di Github dan/atau di dalam komunitas hidrokit:
- Menggunakan bahasa Indonesia atau bahasa Inggris (utamakan bahasa yang Anda kuasai). Penggunaan bahasa Indonesia sangat dianjurkan.
- Hindari menggunakan bahasa daerah, bahasa gaul, atau menyingkat kata/kalimat yang tidak umum.
- Menggunakan panggilan netral dan inklusif.
Berikut daftar yang sebaiknya Anda ketahui saat berkontribusi. Git dan Github memiliki tahapan awal learning curve yang lumayan (belum lagi python π ), sehingga sangat diwajari jika suatu waktu Anda mentok/buntu. Diharapkan hal tersebut tidak membuat Anda mundur untuk memulai/melanjutkan berkontribusi. Jangan ragu untuk menanyakan atau menceritakan pengalaman Anda di komunitas hidrokit.
βIf everyone waited to become an expert before starting, no one would become an expert. To become an EXPERT, you must have EXPERIENCE. To get EXPERIENCE, you must EXPERIMENT! Stop waiting. Start stuff.β - Richie Norton
Git
Karena proyek ini menggunakan Git sebagai version control yang ditampung di GitHub, kontributor diharapkan memahami cara kerja berkontribusi menggunakan Git/Github. Jika ini pertama kalinya Anda menggunakan Git/Github, Anda bisa mengikuti kursus/latihan yang disediakan oleh Github di Github Lab Training. Anda juga bisa mengunjungi masing-masing halaman kategori kontribusi untuk memperoleh panduan lebih detail.
Bacaan lebih lanjut:
Jangan ragu untuk bertanya dan mendiskusikan jika mengalami kesulitan (baik pertanyaan terkait proyek, atau cara berkontribusi).
Github
Proyek ini akan menggunakan wadah Github sebagai alat komunikasi utama, sehingga diharapkan untuk membiasakan dan menyesuaikan bentuk komunikasi. Github menggunakan sintaks penulisan Markdown. Oh π‘, penggunaan emoji π sangat dianjurkan. π
Baca lebih lanjut:
Lisensi
Dalam berkontribusi harap mengingat dan mematuhi lisensi yang berlaku pada sebuah produk yang dimasukkan. Jika Anda menyertakan potongan kode, harap menyertakan lisensinya dan menyertakan pemiliknya. Lisensi proyek hidrokit sendiri mengikuti lisensi MIT. Untuk sumber yang digunakan dalam proyek ini bisa dilihat di halaman Sumber.
Tunggu apa lagi? π€ Ayo langsung buat issue atau pull request! πββοΈ
Mau baca lagi? π² Saya kasih yang lebih detail! π