diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 7e4f6d2f2..1ddcfba25 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -9,3 +9,10 @@ https://github.com/reactjs/react.dev/blob/main/CONTRIBUTING.md If your PR references an existing issue, please add the issue number below --> + +Closes + +## Description + +Translate the page. +Page URL: diff --git a/TRANSLATION.md b/TRANSLATION.md index e9c2a2484..10cdff673 100644 --- a/TRANSLATION.md +++ b/TRANSLATION.md @@ -26,4 +26,64 @@ Konten dari situs id.react.dev terdapat dalam folder `content`, dan disimpan dal ## Klaim Halaman Supaya Tidak Ada Pekerjaan Ganda -Proses penerjemahan akan dicatat dalam *issue* https://github.com/reactjs/id.react.dev/issues/330. Pastikan Anda telah meng-klaim halaman yang Anda ingin menerjemahkan, supaya tidak terjadi pekerjaan ganda. +Proses penerjemahan akan dilacak dalam *issue* https://github.com/reactjs/id.react.dev/issues/330. Pastikan Anda telah meng-klaim halaman yang ingin Anda terjemahkan supaya tidak terjadi pekerjaan ganda. + +### Perubahan mekanisme klaim penerjemahan + +Sebagaimana yang bisa Anda lihat di *issue* https://github.com/reactjs/id.react.dev/issues/330, pada awalnya kami menggunakan penugasan terjemahan berbasis komentar. Namun proses tersebut terlalu menyulitkan dan berpotensi menghambat proses penerjemahan akibat aksi saling menunggu konfirmasi dan potensi miskomunikasi. + +Oleh karena itu, terinspirasi dari mekanisme pembagian tugas di proyek [WargaBantuWarga](https://github.com/kawalcovid19/wargabantuwarga.com/blob/main/CONTRIBUTING.md#issue-assignment--communication), kami mengubah mekanismenya menjadi penugasan berbasis *Draft Pull Request*. + +### Klaim penerjemahan melalui *Draft Pull Request* + +*Draft Pull Request* merupakan *pull request* biasa, namun ia tidak dapat +digabungkan ke *branch* utama sampai statusnya diubah menjadi "ready for +review". *Draft Pull Request* menandakan bahwa *pull request* ini [masih sedang dalam pengerjaan](https://docs.github.com/en/github/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request). +Hal ini diperlukan untuk memberikan sinyal kepada kontributor lainnya bahwa +terjemahan untuk halaman yang dimaksud di dalam *issue* tersebut sudah dimulai dan masih dikerjakan. Membuat *Draft Pull Request* juga merupakan cara yang lebih baik sebagai media komunikasi antara para kontributor karena informasi tambahan bisa disediakan di sana sembari melihat *file-file* yang diubah. + +Dengan membuat *Draft Pull Request* untuk *issue* terkait, kita dapat asumsikan bersama bahwa **Anda telah ditugaskan untuk menerjemahkan halaman tersebut**, sehingga kontributor lain bisa memilih untuk menerjemahkan halaman yang lainnya. Apabila sebuah *Draft Pull Request* dari kontributor lain menggantung terlalu lama tanpa ada kemajuan yang jelas selama beberapa hari, Anda dapat **mengambil alih tugas penerjemahan** halaman tersebut dengan cara membuat *Draft Pull Request* Anda sendiri. Bisa dengan melanjutkan proses penerjemahannya dari *commit* terakhir oleh kontributor lainnya di *Draft Pull Request* yang menggantung tersebut, atau dengan memulainya dari awal lagi (dari *commit* di `main` *branch*). + +#### Pembuatan *Draft Pull Request* + +Langkah-langkah untuk membuat *Draft Pull Request*: + +1. *Commit* dan *push* perubahan terbaru ke *forked repository* Anda. Mohon merujuk ke [@commitlint/config-conventional](https://github.com/conventional-changelog/commitlint/tree/master/@commitlint/config-conventional) untuk membuat pesan *commit* atau Anda dapat menggunakan [commitlint.io](https://commitlint.io/) untuk membantu Anda membuat pesan *commit*. +2. Pergi ke bagian *Pull requests* pada *forked repository* Anda, dan klik *New pull request*. + + ![Petunjuk-1](https://user-images.githubusercontent.com/46013258/126284390-c2bd1aa6-fdc2-4aa6-a945-031f02db038e.png) + +3. Pilih *forked repository* Anda sebagai *head repository*, dan pilih *branch* tempat Anda membuat perubahan untuk bagian *compare*. + + ![Petunjuk-2](https://user-images.githubusercontent.com/46013258/126285036-27b49325-62a2-4a6c-b216-5bae261788da.png) + +4. Berikan judul dan deskripsi yang jelas mengenai *pull request* Anda. + Pastikan Anda mengikuti pengisian deskripsi seperti [keterangan di + bawah](#pemberian-deskripsi-pull-request). + + ![Petunjuk-3](https://user-images.githubusercontent.com/46013258/126286179-04341e30-1224-49cb-9b9a-3c3aee99c308.png) + +5. Pilih *Create draft pull request* (seperti pada gambar di atas) dan klik tombol berwarna hijau. +6. Jangan lupa untuk menandai *Draft Pull Request* Anda sebagai *Ready for review* ketika Anda sudah melakukan semua perubahan yang diinginkan. + +#### Pemberian deskripsi *pull request* + +Agar *pull request* dapat berkaitan dengan *issue*, ada sebuah syarat teks yang +harus dimasukkan ke dalam deskripsinya, yakni dengan format `Closes #nomor-issue`. Harap pastikan Anda menyebutkan nomor +*issue* yang Anda kerjakan dengan benar. Ubah teks `` yang disediakan dari *template* +menjadi nomor *issue*. Contoh, seperti pada https://github.com/reactjs/id.react.dev/pull/500: + +```markdown +Closes #372 + +## Description + +Translate the **Quick Start** page. +Page URL: https://id.react.dev/learn +``` + +Apabila Anda melakukannya dengan benar, maka Anda akan melihat *issue* dan *draft pull request* tersebut saling terhubung sebagaimana yang tampak pada tangkapan layar berikut ini. + +![A Draft Pull Request linked to an Issue](https://user-images.githubusercontent.com/6315466/235304349-125f538f-e9a6-428b-ab55-f01158f0b8d4.png) + +![An Issue linked to a Draft Pull Request](https://user-images.githubusercontent.com/6315466/235304341-f8b2f8dd-c94e-4548-a7da-ce3be49dee17.png)