Skip to content
This repository has been archived by the owner on Oct 6, 2021. It is now read-only.

Latest commit

 

History

History
61 lines (37 loc) · 6.81 KB

CONTRIBUTING_ID.md

File metadata and controls

61 lines (37 loc) · 6.81 KB
Raw

Berkontribusi ke Silacak

Cara berkontribusi

Dalam proyek ini, kita memaksimalkan penggunaan fitur-fitur GitHub untuk mendokumentasikan dan memberikan sinyal terhadap kemajuan apapun dalam pengerjaan website ini.

Menemukan atau membuat issues

Sebagian besar kontribusi berawal dari membuat Issues. Tiap orang dapat memulai membuat Issues untuk diskusi. Anda dapat mengunjungi pranala ini untuk pemahaman lebih lanjut mengenai Issues. Secara spesifik, Anda dapat menemukan Issues di tab Issues ini. Hanya ada dua kategori bagian pada Issues, yakni Open dan Closed Issues.

Open Issues

Open Issues merupakan kategori yang membutuhkan perhatian lebih serta penyelesaian. Kontributor disarankan menelusuri bagian Open Issues dan mulai mengerjakannya.

Closed Issues

Closed Issues merupakan kategori issue yang sudah selesai dikerjakan atau tidak membutuhkan aksi lanjutan. Issue dengan status closed dapat kembali diubah menjadi open ketika kontibutor menemukan issue yang berhubungan di masa mendatang.

Mohon perhatikan tiap atribut issue. Tiap issue kemungkinan dikerjakan oleh kontributor lain melalui Linked Pull Requests. Ini berarti issue sedang dalam penanganan. Untuk menghindari pekerjaan yang sama, kontributor sangat dianjurkan untuk mengajukan sebuah draft pull request terlebih dahulu setiap kali hendak mengerjakan suatu issue.

Untuk Pemula: label good first issue

Seperti yang tertulis di sini, good first issue merupakan sebuah fitur label dari GitHub yang diciptakan untuk membantu para kontributor pemula dalam berkontribusi ke sebuah proyek open-source. good first issue memberitakan kita mengenai tingkat kesulitan dari sebuah issue. Ini berarti, bahwa sebuah issue dengan label good first issue cocok sekali bagi kontributor pemula yang ingin melakukan kontribusi pertama mereka ke sebuah proyek open-source.

Bagaimana cara mencari issue dengan label good first issue:

  1. Cara paling mudah adalah dengan mengunjungi pranala github.com/<owner>/<repository>/contribute. Dalam hal ini, Anda dapat mengunjungi pranala ini. Pranala tersebut akan memberikan daftar dari semua issue dengan label good first issue.
  2. Atau cara lainnya adalah dengan mengunjungi bagian Issues dari sebuah repository, lalu klik bagian Labels di sebelah Milestones. Di sana, Anda dapat melihat banyak label untuk issues yang terdapat dalam repository tersebut. Lalu cari dan klik label good first issue.

Panduan mulai bekerja

Sebelum mengerjakan sebuah issue, ada hal yang harus diperhatikan:

  1. Apakah ada kontributor lain yang sedang mengerjakannya? Anda dapat mencari apakah ada pull request terkait sebelum memutuskan untuk mulai mengerjakan issue tersebut.
  2. Untuk mulai mengerjakannya, pastikan create branch dari main, lalu segera commit dan push perubahannya sesegera mungkin sekecil apapun itu.
  3. Kemudian buat pull request baru dengan menjadikannya sebagai draft pull request untuk memberikan sinyal kepada kontributor lainnya bahwa pull request ini masih sedang dalam pengerjaan. Dengan demikian, orang lain yang ingin mengerjakan issue yang sama akan berpikir dua kali sebelum ikut mengerjakannya.

Memanfaatkan Draft Pull Requests untuk Berkomunikasi

Draft Pull Requests merupakan sebuah fitur yang disediakan oleh GitHub, yang bertujuan sebagai alat berkomunikasi bagi para kontributor. Ketika kita membuat sebuah Draft Pull Request, kita tidak bisa menggabungkannya melainkan kita sudah menandainya sebagai Ready for review. Ini merupakan pendekatan yang lebih baik untuk menggunakannya sebagai alat berkomunikasi antar kontributor, dan kita juga bisa memberikan informasi bahwa kita sedang mengatasi sebuah isu.

Langkah-langkah untuk membuat Draft Pull Request:

  1. Commit dan push perubahan terbaru ke forked repository Anda.
  2. Pergi ke bagian Pull requests pada forked repository Anda, dan klik New pull request. Petunjuk-1
  3. Pilih forked repository Anda sebagai head repository, dan pilih branch tempat Anda membuat perubahan untuk bagian compare. Petunjuk-2
  4. Berikan sebuah judul dan beberapa deskripsi mengenai pull request Anda, lalu pilih Create draft pull request (seperti pada gambar di bawah) dan klik tombol berwarna hijau. Petunjuk-3
  5. Jangan lupa untuk menandai Draft Pull Request Anda sebagai Ready for review ketika Anda sudah melakukan semua perubahan yang diinginkan.

Pertanyaan yang sering ditanyakan

Mengapa kita menggunakan bahasa Inggris dalam menulis issue dan pull request?

Ada beberapa alasan mengapa kita menggunakan bahasa Inggris ketika berkomunikasi di dalam issue dan pull request:

  1. Secara alamiah, lebih mudah untuk software engineer berkomunikasi dalam bahasa Inggris, karena terminologi-terminologi teknis yang digunakan dalam pemrograman pun berbahasa Inggris. Menerjemahkannya ke Bahasa Indonesia memunculkan resiko miskomunikasi, sementara menggunakan Bahasa Inggris membutuhkan banyak penyesuaian penulisan dalam bentuk italic mengacu pada PUEBI.
  2. Membiasakan para kontributor yang mayoritas berasal dari Indonesia untuk berkomunikasi dengan bahasa Inggris. Sangat penting untuk mengasah kemampuan menulis dan membaca bahasa Inggris kita karena sebagian besar dari komunitas open-source di seluruh dunia menggunakan bahasa Inggris sebagai bahasa utama mereka.
  3. Menggunakan bahasa Inggris membuat proyek ini lebih mudah diakui secara global. Apabila kita ingin mendapatkan dukungan dari komunitas global, mereka lebih mudah memahami tujuan kita, sehingga mereka lebih mudah untuk meluangkan waktu dan keahlian mereka untuk membantu membuat proyek ini lebih baik. Contohnya menyediakan free credits untuk layanan mereka, mengadvokasikan proyek ini kepada pemimpin dunia, atau berkontribusi langsung ke proyek kita.