ID translation for suggest-improvements
Apply suggestions from code review Co-authored-by: Giri Kuncoro <girikuncoro@users.noreply.github.com>
This commit is contained in:
parent
731e2506d3
commit
ef4c104cf0
|
|
@ -0,0 +1,65 @@
|
|||
---
|
||||
title: Menyarankan peningkatan kualitas konten
|
||||
slug: suggest-improvements
|
||||
content_type: concept
|
||||
weight: 10
|
||||
card:
|
||||
name: contribute
|
||||
weight: 20
|
||||
---
|
||||
|
||||
<!-- overview -->
|
||||
|
||||
Jika kamu menemukan masalah pada dokumentasi Kubernetes, atau mempunyai ide untuk
|
||||
konten baru, maka silakan untuk membuat isu pada Github. Kamu hanya membutuhkan
|
||||
sebuah [akun Github](https://github.com/join) dan sebuah _web browser_.
|
||||
|
||||
Pada kebanyakan kasus, pekerjaan dalam dokumentasi Kubernetes diawali dengan sebuah
|
||||
isu pada Github. Kontributor Kubernetes akan mengkaji, mengkategorisasi dan menandai isu
|
||||
sesuai kebutuhan. Selanjutnya, kamu atau anggota lain dari komunitas Kubernetes dapat membuat
|
||||
_pull request_ dengan perubahan yang akan menyelesaikan masalahnya.
|
||||
|
||||
<!-- body -->
|
||||
|
||||
## Membuka sebuah issue
|
||||
|
||||
Jika kamu mau menyarankan peningkatan kualitas pada konten yang sudah ada, atau menemukan kesalahan,
|
||||
maka silakan membuka sebuah isu.
|
||||
|
||||
1. Turun ke bagian bawah dari suatu halaman dan klik pada tombol **Buat Isu**. Ini akan
|
||||
mengantarmu pada halaman Github isu dengan beberapa tajuk yang telah diisi.
|
||||
2. Deskripsikan isu atau saran untuk peningkatan kualitas. Sediakan detail sebanyak mungkin yang kamu bisa.
|
||||
3. Klik **Submit new issue**
|
||||
|
||||
Setelah dikirim, cek isu yang kamu buat secara berkala atau hidupkan notifikasi Github.
|
||||
Pengulas (_reviewer_) atau anggota komunitas lainnya mungkin akan menanyakan pertanyaan
|
||||
sebelum mereka mengambil suatu tindakan terhadap isumu.
|
||||
|
||||
## Menyarankan konten baru
|
||||
|
||||
Jika kamu memiliki ide untuk konten baru, tapi kamu tidak yakin dimana mengutarakannya,
|
||||
kamu tetap dapat membuat sebuah isu. Antara lain:
|
||||
|
||||
- Pilih halaman pada bagian yang menurutmu konten tersebut berhubungan dan klik **Buat Isu**.
|
||||
- Pergi ke [Github](https://github.com/kubernetes/website/issues/new/) dan langsung membuat isu.
|
||||
|
||||
## Bagaimana cara membuat isu yang bagus
|
||||
|
||||
Perhatikan hal berikut ketika membuat sebuah isu:
|
||||
|
||||
- Memberikan deskripsi isu yang jelas. Deskripsikan apa yang memang kurang, tertinggal,
|
||||
salah atau konten mana yang memerlukan peningkatan kualitas.
|
||||
- Jelaskan dampak spesifik dari isu terhadap pengguna.
|
||||
- Batasi cakupan dari sebuah isu menjadi ukuran pekerjaan yang masuk akal.
|
||||
Untuk masalah dengan cakupan yang besar, pecah isu itu menjadi beberapa isu lebih kecil.
|
||||
Misal, "Membenahi dokumentasi keamanan" masih sangat luas cakupannya, tapi "Penambahan
|
||||
detail pada topik 'Pembatasan akses jaringan'" adalah lebih spesifik untuk dikerjakan.
|
||||
- Mencari isu yang sudah ada untuk melihat apakah ada sesuatu yang berhubungan atau
|
||||
mirip dengan isu yang baru.
|
||||
- Jika isu yang baru berhubungan dengan isu lain atau _pull request_, tambahkan rujukan
|
||||
dengan menuliskan URL lengkap atau dengan nomor isu atau _pull request_ yang diawali dengan
|
||||
karakter `#`. Contohnya, `Diajukan oleh #987654`.
|
||||
- Mengikuti [Kode Etik Komunitas](/id/community/code-of-conduct/). Menghargai kontributor lain.
|
||||
Misalnya, "Dokumentasi ini sangat jelek" adalah contoh yang tidak membantu dan juga bukan
|
||||
masukan yang sopan.
|
||||
|
||||
Loading…
Reference in New Issue