Peninjau Basis Pengetahuan kami adalah para kontributor dan staf Mozilla yang memiliki pengalaman dan keahlian dalam menulis dokumentasi dukungan. Berikut adalah beberapa panduan untuk meninjau artikel.

Tujuan

Sebagai peninjau Basis Pengetahuan, peran Anda sangat penting dalam menjaga akurasi, kejelasan, dan konsistensi konten dukungan di Basis Pengetahuan kami. Pekerjaan peninjauan Anda memastikan pengguna dapat mempercayai artikel kami dan menemukan bantuan dengan mudah.

Tanggung jawab utama

Sebagai peninjau KB, saat Anda meninjau revisi, selalu pastikan bahwa revisi tersebut:

• Akurat dan mutakhir
• Menggunakan bahasa dan nada yang jelas dan konsisten
• Selaras dengan pedoman editorial Mozilla
• Menyertakan pemformatan, tautan, dan markup yang benar dan berfungsi
• Mengikuti praktik terbaik aksesibilitas dan lokalisasi
• Memenuhi cakupan artikel dan versi produk

Panduan peninjauan

Sebagian besar revisi dibuat oleh orang-orang yang menyumbangkan waktu dan bakat mereka secara sukarela. Saat menangani pekerjaan yang telah dikirimkan orang, asumsikan bahwa setiap orang memiliki niat terbaik dan pastikan untuk berterima kasih atas kontribusi mereka. Ingat, Anda mungkin menjadi kontak pertama dan satu-satunya yang dimiliki orang tersebut dengan seseorang dari Mozilla. Harap buat pengalaman itu positif.

Kebijakan peninjauan Basis Pengetahuan

Untuk pembaruan besar, penting untuk membedakan antara persetujuan konten dan peninjauan konten, karena ini adalah dua proses yang terpisah.

• Persetujuan konten dilakukan oleh pemangku kepentingan produk terutama untuk memvalidasi akurasi teknis konten.
• Peninjauan konten dilakukan oleh peninjau KB untuk memastikan kualitas editorial dan pemformatan artikel.

Lihat Penugasan kontributor untuk permintaan konten untuk detail lebih lanjut tentang perbedaan ini.

Kapan peninjauan staf diperlukan?

Peninjauan staf diperlukan untuk:

• Artikel baru
• Pembaruan besar yang secara eksplisit ditandai dengan “Diperlukan peninjauan staf” dalam catatan revisi

Kapan kontributor dengan izin peninjauan KB dapat meninjau revisi?

Kontributor dengan izin peninjauan KB dapat meninjau:

• Revisi yang diklasifikasikan sebagai perubahan kecil
• Perubahan besar yang tidak memerlukan peninjauan staf

Lihat Perubahan kecil vs besar untuk mempelajari lebih lanjut tentang bagaimana pembaruan konten diklasifikasikan berdasarkan cakupan dan dampaknya.

Tempat menemukan artikel yang belum ditinjau

Ada beberapa cara untuk menemukan artikel yang belum ditinjau:

• Ringkasan Basis Pengetahuan: Halaman ini memberi Anda daftar artikel berdasarkan urutan jumlah penayangan halaman dalam 30 hari terakhir. Kolom Status akan menunjukkan artikel mana yang memerlukan peninjauan. Anda juga dapat memfilter berdasarkan produk dan jenis artikel.
• Perubahan yang Belum Ditinjau: Halaman ini menyediakan cara alternatif untuk melihat artikel mana yang memerlukan peninjauan, serta berapa lama setiap revisi telah menunggu untuk ditinjau. Anda dapat memilih untuk mengurutkan berdasarkan penayangan halaman/perubahan terbaru, dan Anda juga dapat memfilter berdasarkan produk.
• Paling Banyak Dikunjungi: Halaman ini memberi Anda daftar artikel Basis Pengetahuan berdasarkan jumlah penayangan halaman. Di kolom Status, Anda akan dapat melihat artikel mana yang memerlukan peninjauan.

Prioritas

Saat meninjau beberapa artikel, penting untuk memprioritaskan upaya Anda secara strategis. Pertimbangkan hal berikut:

• Artikel dengan penayangan halaman tinggi: Artikel dengan jumlah penayangan tinggi harus diprioritaskan untuk memastikan pengguna mengakses informasi yang paling akurat dan mutakhir. Anda dapat dengan mudah mengidentifikasi ini dengan mengurutkan daftar Perubahan yang Belum Ditinjau berdasarkan jumlah penayangan.
• Artikel yang ditautkan dalam produk: Jika Anda adalah bagian dari salah satu grup kontribusi (Forum, KB, L10n) atau grup “Staf”, Anda mungkin melihat indikator yang menunjukkan bahwa sebuah artikel ditautkan dalam produk. Artikel-artikel ini umumnya harus menjadi prioritas, karena berdampak langsung pada pengalaman pengguna.

  

Artikel khusus

• Templat menyertakan konten yang digunakan kembali di beberapa artikel dan harus dianggap sebagai prioritas tinggi karena dampaknya yang lebih luas. Semua templat, termasuk yang memerlukan peninjauan, tercantum di papan ini. Untuk panduan tentang cara menggunakan templat dalam artikel, silakan merujuk ke Using Templates.
• Respons Kalengan adalah respons standar yang digunakan di Forum Komunitas. Karena sering digunakan kembali, setiap pembaruan harus dikoordinasikan dengan tim Komunitas. Daftar semua respons forum, termasuk yang memerlukan peninjauan, tersedia di papan lain ini. Untuk panduan tambahan tentang membuat atau meningkatkan respons umum, lihat Buat atau tingkatkan respons forum umum.

Persyaratan khusus untuk produk langganan atau premium

Pengajuan konten

Jika Anda ingin menyarankan konten baru atau mengusulkan perubahan, silakan ajukan tiket Bugzilla atau hubungi seorang anggota staf. Anda dapat menghubungi kami baik di Matrix atau di saluran #sumo-team di Slack (untuk kontributor dengan akses Slack).

Peninjauan dan persetujuan revisi KB

Persetujuan staf diperlukan untuk semua revisi yang terkait dengan produk Langganan atau Premium. Ini termasuk Respons Kalengan dan Templat yang terkait dengan produk-produk ini.

Sebagai referensi, produk Langganan atau Premium saat ini meliputi:

• Mozilla VPN
• Firefox Relay
• Mozilla Monitor
• MDN Plus

Meninjau artikel

Memilih tingkat revisi

Saat Anda menyetujui sebuah artikel, Anda memiliki tiga tingkat revisi berbeda untuk dipilih. Tingkat-tingkat ini akan menentukan kebutuhan dan prioritas untuk lokalisasi.

• Detail kecil yang tidak memengaruhi instruksi: Ini adalah perubahan yang tidak akan mengubah instruksi kepada pengguna. Pelokal tidak akan diberi tahu tentang perubahan ini.
• Perubahan konten yang tidak memerlukan terjemahan segera: Ini adalah pilihan default. Ini adalah perubahan besar (pembaruan dan perubahan besar) yang tidak sepenuhnya membatalkan versi artikel sebelumnya. Pelokal tidak akan segera diberi tahu tentang perubahan tersebut, tetapi revisi dapat ditandai sebagai Siap untuk Lokalisasi nanti dan itu akan memicu pemberitahuan untuk para pelokal.
• Perubahan konten besar yang akan membuat terjemahan lama menjadi tidak akurat: Ini dapat digunakan ketika pembaruan akan menyebabkan konten sebelumnya menjadi usang. Menandai artikel dengan ini akan memicu peringatan pada artikel yang dilokalkan bahwa kontennya mungkin sudah usang dan menyediakan tautan ke versi bahasa Inggris untuk informasi yang paling mutakhir.

  

Memberikan umpan balik untuk editor

Saat menyetujui sebuah artikel, penting untuk berterima kasih kepada editor atas kontribusi mereka. Juga baik jika Anda dapat memberi mereka umpan balik. Apakah tulisan mereka membaik? Apakah mereka melakukan pekerjaan yang sangat baik dalam menjelaskan sesuatu yang rumit? Beri tahu mereka!

Menangguhkan revisi

Jika sebuah revisi tidak terlalu membantu, Anda dapat menangguhkan revisi yang diusulkan. Namun, alih-alih penolakan sederhana, penangguhan adalah kesempatan Anda untuk bekerja dengan penulis revisi untuk meningkatkan revisi mereka. Anda dapat melakukannya dengan meninggalkan pesan di kolom komentar untuk berterima kasih kepada penulis dan kemudian memberikan umpan balik yang spesifik dan konstruktif tentang apa yang Anda rasa perlu diubah agar revisi tersebut dapat diterima. Pastikan juga untuk menyertakan tautan ke dokumentasi atau panduan yang relevan.

Meninjau beberapa revisi

Ketika ada beberapa revisi yang menunggu persetujuan, pastikan untuk memeriksa semua revisi mulai dari yang paling lama sebelum membuat keputusan. Penting untuk dicatat bahwa Anda tidak dapat meninjau revisi yang lebih lama ketika revisi yang lebih baru telah disetujui. Anda akan melihat bahwa revisi tersebut masih menunggu persetujuan, tetapi tidak mungkin untuk meninjaunya.

Membutuhkan perubahan

Saat menyetujui revisi, Anda harus memutuskan apa, jika ada, yang masih perlu diubah. Jika semua yang ditentukan dalam komentar “Membutuhkan perubahan” telah ditangani, Anda dapat menghapus centangnya (menghapus komentar) dan menyetujui artikel. Jika masih ada hal yang perlu dilakukan, pastikan kotak centang dicentang dan perbarui komentar. Dengan cara ini, kita dapat dengan mudah melacak pekerjaan apa yang perlu dilakukan pada artikel.

Memberikan kredit

Terkadang orang yang berpartisipasi dalam diskusi tentang sebuah artikel memberikan kontribusi signifikan pada revisi meskipun mereka bukan orang yang benar-benar mengedit wiki. Dalam kasus seperti ini, Anda dapat mengedit daftar kontributor sebuah artikel (di halaman riwayat artikel) untuk menyertakan mereka. Poin bonus jika Anda memberi tahu mereka bahwa Anda melakukan ini!

Cara memberikan kredit kepada kontributor di KB

• Untuk menambahkan kontributor, buka halaman Tampilkan Riwayat sebuah artikel
• Gulir ke bawah di bawah revisi dan klik tautan Edit kontributor
• Ketik nama kontributor lalu klik Add Contributor

Menangani spam dan suntingan yang keliru

Dalam kasus spam, Anda cukup menghapus revisi dengan mengeklik ikon tempat sampah di riwayat revisi artikel dan mengonfirmasi. Dalam kasus pengiriman yang keliru (tidak ada perubahan) dan permintaan bantuan yang salah tempat (suntingan pada dasarnya adalah pertanyaan dukungan), Anda harus menangguhkan dan menyertakan pesan ini di komentar Anda:
Hai.
Tampaknya Anda mungkin mencoba mendapatkan bantuan dengan Firefox. Jika demikian, silakan ajukan pertanyaan Anda lagi di sini, https://support.mozilla.org/questions/new agar kami dapat membantu Anda dengan lebih baik.
Maaf atas ketidaknyamanannya.

Setelah Anda melakukan itu, Anda dapat menghapus revisi.

Siap untuk lokalisasi

Bagaimana cara kerja “Siap Untuk Lokalisasi” (RFL)?

Untuk mencegah kontributor menerjemahkan artikel yang masih diperbarui, sistem hanya mengizinkan terjemahan versi yang telah ditandai secara eksplisit Siap untuk Lokalisasi (RFL). Ketika pelokal mengeklik Translate article, mereka akan diberikan revisi terbaru yang telah ditandai sebagai RFL.

Setelah revisi baru disetujui, artikel tidak akan muncul di dasbor lokalisasi sebagai membutuhkan pembaruan kecuali bendera Siap untuk Lokalisasi (RFL) dicentang. Ketika bendera RFL diatur, sistem juga mengirimkan pemberitahuan email kepada semua orang yang memantau artikel, memberitahu mereka bahwa artikel tersebut siap untuk dilokalkan.

Menandai artikel sebagai RFL

Menandai revisi artikel sebagai “Siap untuk lokalisasi” berarti kami memberi tahu para pelokal bahwa versi bahasa Inggris sudah selesai dan dapat diterjemahkan tanpa khawatir artikel tersebut akan berubah beberapa kali lagi sebelum mereka selesai.

Lokalisasi adalah pekerjaan yang banyak dan sering kali dilakukan hanya oleh satu orang. Ini tidak selalu mudah, tetapi cobalah untuk memastikan bahwa semua perubahan yang diperlukan dilakukan sebelum rilis Firefox sehingga para pelokal dapat menggunakan waktu ekstra itu untuk menyelesaikan pekerjaan mereka.

Menandai artikel sebagai RFL pasca-peninjauan

Jika Anda tidak menandai revisi sebagai siap untuk lokalisasi saat menyetujuinya (seperti dalam kasus di atas), Anda dapat menandainya siap kapan saja dengan mengeklik entri status “Tidak siap untuk lokalisasi” (simbol ✕) di bawah kolom R dari riwayat revisi artikel dan mengonfirmasi.

Revisi yang telah ditandai RFL memiliki simbol tanda centang ✓.

Protokol RFL

Semua peninjau kontributor harus mematuhi protokol lokalisasi berikut:

• Semua staf Mozilla dan peninjau kontributor dapat menandai artikel baru atau pembaruan artikel sebagai siap untuk lokalisasi.
• Semua artikel baru dan revisi yang memperkenalkan informasi baru atau yang diubah harus ditandai untuk lokalisasi, kecuali jika ditentukan lain oleh tim Produk berdasarkan ketersediaan regional.
• Jika revisi tidak mengubah instruksi, akurasi, atau pengalaman pengguna, prioritas lokalisasi harus diturunkan sesuai.
• Dalam beberapa kasus, staf Mozilla mungkin meninggalkan sintaks komentar atau komentar revisi dalam sebuah artikel untuk menunjukkan bahwa terjemahan sudah diajukan untuk lokalisasi internal di lokal tertentu. Jika sintaks komentar menunjukkan bahwa sebuah artikel atau revisi sudah diajukan untuk lokalisasi internal, kontributor tidak boleh melokalkannya secara mandiri.

Kesiapan rilis

Untuk memastikan bahwa kami siap mendukung rilis Firefox on-train yang akan datang, berikut adalah beberapa panduan mengenai linimasa untuk kesiapan rilis. Artikel yang terkait dengan rilis berikutnya adalah artikel baru atau pembaruan konten yang mencakup fungsionalitas yang diperkenalkan pada rilis berikutnya. Panduan berikut berlaku untuk artikel dengan konten terkait rilis.

Kalender rilis Firefox

4 minggu sebelum rilis berikutnya

• Mulai merencanakan dan menyusun draf konten untuk rilis mendatang; belum ada pekerjaan untuk pelokal.
• Semua artikel yang ada tetap terbuka untuk pengeditan dan lokalisasi seperti biasa.

1-2 minggu sebelum rilis berikutnya

• Draf konten untuk rilis mendatang mungkin sudah siap secara internal; namun, publikasi biasanya menunggu hingga tanggal rilis resmi untuk memperhitungkan perubahan di menit-menit terakhir.
• Jika konten memerlukan lokalisasi sebelum rilis, tim produk harus memberi tahu staf CX agar kami dapat berkoordinasi dengan komunitas lokalisasi untuk memastikan tenggat waktu terpenuhi.

Hari rilis

• Perubahan konten harus dipublikasikan di Basis Pengetahuan en-US. Pelokal harus memprioritaskan penerjemahan artikel yang terkait dengan rilis baru.

Saluran diskusi dan eskalasi

Tidak semua peninjau KB secara aktif memantau Diskusi KB. Jika Anda perlu menjangkau seluruh grup peninjau KB, silakan kirim email ke kb-reviewers@mozilla.com.

Evaluasi peran

Membuat konten yang akurat, konsisten, dan relevan itu penting, dan mempertahankan kualitas tersebut dari waktu ke waktu memerlukan standar bersama dan penyelarasan berkelanjutan.

Sebagai peninjau Basis Pengetahuan, Anda memainkan peran penting dalam menegakkan standar tersebut. Untuk memastikan grup peninjau kami tetap aktif dan selaras dengan praktik saat ini, tim Komunitas melakukan tinjauan tahunan ringan berdasarkan partisipasi dan kepatuhan terhadap pedoman.

Untuk mempertahankan izin peninjau KB Anda, kami meminta Anda untuk:

• Tetap selaras: Patuhi Panduan Partisipasi Komunitas dan pedoman peninjau KB yang diuraikan dalam artikel ini.
• Tetap aktif: Tinjau setidaknya tiga (3) revisi dalam periode enam bulan.

Jika Anda belum aktif atau jika muncul pertanyaan tentang kepatuhan pedoman, tim Komunitas dapat menghubungi Anda untuk memeriksa sebelum mengambil tindakan apa pun. Tujuan kami bukan untuk menghapus izin, tetapi untuk memastikan peninjau merasa terlibat, didukung, dan selaras dengan proses saat ini.

Jika keadaan berubah dan Anda perlu mundur, kami sepenuhnya memahami. Karena ini adalah peran sukarela, waktu dan ketersediaan Anda mungkin berubah secara alami. Jangan ragu untuk memberi tahu tim Komunitas ketika itu terjadi. Kami selalu senang untuk terhubung kembali ketika Anda siap untuk terlibat kembali.

—

Dengan bekerja sama dan melibatkan orang lain dalam proses peninjauan dan persetujuan, kita dapat mempertahankan standar kualitas tertinggi dan memastikan bahwa konten kita adalah yang terbaik. Terima kasih atas kerja sama Anda, dan mari kita terus membuat revisi yang luar biasa untuk pengguna kita!