Skip to content

Commit b27e5a6

Browse files
authored
docs(translation): update assignment mechanism into using draft PRs (#501)
1 parent fa2ce17 commit b27e5a6

File tree

2 files changed

+68
-1
lines changed

2 files changed

+68
-1
lines changed

.github/PULL_REQUEST_TEMPLATE.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,3 +9,10 @@ https://github.com/reactjs/react.dev/blob/main/CONTRIBUTING.md
99
If your PR references an existing issue, please add the issue number below
1010
1111
-->
12+
13+
Closes <!-- mention the issue that you're trying to close with this PR -->
14+
15+
## Description
16+
17+
Translate the <!-- mention the page title that you're translating --> page.
18+
Page URL: <!-- mention the URL to the page that you're translating -->

TRANSLATION.md

Lines changed: 61 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,4 +26,64 @@ Konten dari situs id.react.dev terdapat dalam folder `content`, dan disimpan dal
2626

2727
## Klaim Halaman Supaya Tidak Ada Pekerjaan Ganda
2828

29-
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.
29+
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.
30+
31+
### Perubahan mekanisme klaim penerjemahan
32+
33+
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.
34+
35+
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*.
36+
37+
### Klaim penerjemahan melalui *Draft Pull Request*
38+
39+
*Draft Pull Request* merupakan *pull request* biasa, namun ia tidak dapat
40+
digabungkan ke *branch* utama sampai statusnya diubah menjadi "ready for
41+
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).
42+
Hal ini diperlukan untuk memberikan sinyal kepada kontributor lainnya bahwa
43+
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.
44+
45+
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*).
46+
47+
#### Pembuatan *Draft Pull Request*
48+
49+
Langkah-langkah untuk membuat *Draft Pull Request*:
50+
51+
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*.
52+
2. Pergi ke bagian *Pull requests* pada *forked repository* Anda, dan klik *New pull request*.
53+
54+
![Petunjuk-1](https://user-images.githubusercontent.com/46013258/126284390-c2bd1aa6-fdc2-4aa6-a945-031f02db038e.png)
55+
56+
3. Pilih *forked repository* Anda sebagai *head repository*, dan pilih *branch* tempat Anda membuat perubahan untuk bagian *compare*.
57+
58+
![Petunjuk-2](https://user-images.githubusercontent.com/46013258/126285036-27b49325-62a2-4a6c-b216-5bae261788da.png)
59+
60+
4. Berikan judul dan deskripsi yang jelas mengenai *pull request* Anda.
61+
Pastikan Anda mengikuti pengisian deskripsi seperti [keterangan di
62+
bawah](#pemberian-deskripsi-pull-request).
63+
64+
![Petunjuk-3](https://user-images.githubusercontent.com/46013258/126286179-04341e30-1224-49cb-9b9a-3c3aee99c308.png)
65+
66+
5. Pilih *Create draft pull request* (seperti pada gambar di atas) dan klik tombol berwarna hijau.
67+
6. Jangan lupa untuk menandai *Draft Pull Request* Anda sebagai *Ready for review* ketika Anda sudah melakukan semua perubahan yang diinginkan.
68+
69+
#### Pemberian deskripsi *pull request*
70+
71+
Agar *pull request* dapat berkaitan dengan *issue*, ada sebuah syarat teks yang
72+
harus dimasukkan ke dalam deskripsinya, yakni dengan format `Closes #nomor-issue`. Harap pastikan Anda menyebutkan nomor
73+
*issue* yang Anda kerjakan dengan benar. Ubah teks `<!-- mention the issue that you're trying to close with this PR -->` yang disediakan dari *template*
74+
menjadi nomor *issue*. Contoh, seperti pada https://github.com/reactjs/id.react.dev/pull/500:
75+
76+
```markdown
77+
Closes #372
78+
79+
## Description
80+
81+
Translate the **Quick Start** page.
82+
Page URL: https://id.react.dev/learn
83+
```
84+
85+
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.
86+
87+
![A Draft Pull Request linked to an Issue](https://user-images.githubusercontent.com/6315466/235304349-125f538f-e9a6-428b-ab55-f01158f0b8d4.png)
88+
89+
![An Issue linked to a Draft Pull Request](https://user-images.githubusercontent.com/6315466/235304341-f8b2f8dd-c94e-4548-a7da-ce3be49dee17.png)

0 commit comments

Comments
 (0)