wiki
This page contains an outdated translation of the original content. Please check the English version for the most accurate information (and consider updating the translation if you are able to help out)!

Pemeliharaan osu! wiki

Lihat juga: panduan kontribusi osu! wiki

Artikel ini menjelaskan aspek teknis atau administratif dari osu! wiki. Artikel ini juga mencakup prosedur pemeliharaan yang diperlukan agar tetap mutakhir—yang mungkin kamu dapat berkontribusi pada salah satu rutinitas. Untuk semua diskusi yang terkait dengan wiki, gunakan channel #osu-wiki di server Discord osu!.

Administrator

Halaman utama: Daftar pengelola osu! wiki

Administrator adalah orang-orang dengan akses kolaborator di repositori ppy/osu-wiki, tempat semua artikel dan postingan berita disimpan. Mereka dapat menentukan skala prioritas dan memberi label pada issue, mengelola open pull request, serta membuat keputusan terkait osu! wiki saat ini dan masa depan.

Pengelola melakukan tinjauan akhir pull request dan menggabungkannya. Jika kamu memiliki kontribusi yang membutuhkan perhatian, tanyakan salah satu dari mereka di channel #osu-wiki.

Detail teknis

Issue Tracker

Issue tracker osu! wiki berisi ide dan permintaan untuk kemungkinan perbaikan, baik untuk artikel itu sendiri maupun bagian situs web yang terkait dengan wiki. Bukalah sebuah issue jika kamu memiliki permintaan fitur, atau jika kamu menemukan kesalahan pada salah satu halaman. Harap diperhatikan bahwa ini hanya terbatas pada osu! wiki—jika kamu memerlukan bantuan dengan proyek resmi lain yang terkait dengan osu!, gunakan issue tracker mereka sendiri:

Label issue

Di GitHub, pull request dan issue dapat ditandai dan diklasifikasikan dengan menggunakan label, yang menunjukkan aspek berbeda dari pull request atau issue. Label bersifat informasional, ditetapkan oleh pengelola wiki, dan biasanya cukup jelas. Meskipun tidak memerlukan tindakan dari sudut pandang pengguna, label merah berfungsi sebagai pengingat atau ajakan bertindak untuk pengelola lainnya:

  • rule change: perubahan memengaruhi seperangkat aturan yang ada, seperti kriteria ranking, dan perlu ditinjau oleh pemilik area
  • blocked: perubahan memiliki masalah yang harus diselesaikan sebelum melanjutkan, atau tergantung pada masalah lain yang harus diselesaikan terlebih dahulu
  • needs native review: terjemahan perlu diperiksa oleh orang yang fasih dalam bahasa masing-masing; sebagai alternatif, selama proses penggabungan itu berarti tidak ada tinjauan seperti itu yang terjadi
  • needs rebase: pull request memiliki terlalu banyak commit kecil yang tidak terstruktur, yang perlu di-rebase dan disusun dengan cara yang lebih baik; ini biasanya dilakukan oleh pengelola tepat sebelum penggabungan

Tautan dan pengalihan

Kebanyakan artikel osu! wiki memiliki tautan alternatif, yang disiapkan menggunakan berkas redirect.yaml. Pengalihan dimaksudkan untuk digunakan di luar osu! wiki, misalnya, di forum, atau di chat, di mana mereka dapat dengan cepat diubah menjadi referensi sebaris, contohnya:

Menurut [[RC]], ini dilarang.

Saat menambahkan pengalihan untuk artikel baru atau yang sudah ada, ingatlah bahwa pengalihan harus ringkas dan dirancang untuk penggunaan sebenarnya.

CI check

Repositori osu! wiki menggunakan continuous integration (CI) untuk secara otomatis memeriksa berbagai kesalahan umum dalam pull request yang masuk. Daftar pemeriksaan dikonfigurasi dalam berkas continuous-integration.yml.

Berkas package.json mencantumkan semua plugin yang digunakan oleh CI, yang sebagian ditulis oleh pengelola osu! wiki.

Pemeriksaan CI dijalankan secara otomatis pada setiap commit dari kontributor berulang. Agar pull request mereka digabungkan, kontributor diharapkan memperbaiki kesalahan yang dilaporkan oleh CI. Untuk melihat status pemeriksaan, lakukan hal berikut:

  1. Navigasikan ke bawah halaman pull request dan temukan bagian status osu-wiki continuous integration, lalu klik tautan Details.
  2. Pada halaman baru, lebarkan bagian langkah run remark on changed files. Setiap temuan disertai dengan lokasi persis berkas tersebut dan deskripsi singkat mengapa terjadi kegagalan pada pengecekan berkas tersebut.

Jika kamu memerlukan bantuan untuk mendekripsi kesalahan pemeriksaan CI, atau memperbaiki masalah, tanyakan di channel #osu-wiki di Discord.

Perkembangan

osu! wiki terintegrasi ke dalam situs web osu!, yang berarti semua permintaan fitur teknis harus dibuat dan dilacak di repositori ppy/osu-web. Kamu dapat memberi tahu kontributor lain tentang permintaan kamu dengan menautkan masalah tersebut di saluran Discord #osu-wiki atau issue tracker.

Peralatan

Beberapa fitur mungkin tidak berhubungan langsung dengan situs web osu!, tetapi mungkin berguna untuk berkontribusi atau pembenahan. Dalam kasus tersebut, fitur-fitur ini diimplementasikan oleh orang yang mampu membuat hal tersebut dan tidak ditambahkan ke situs web secara langsung:

  • status osu-wiki: daftar artikel per bahasa, dan kategori pemeliharaan yang diperlukan (terjemahan, pembaruan, perluasan rintisan). Lihat ppy/osu-wiki#2486 untuk permintaan fungsionalitas.
  • osu-wiki-bin: utilitas Node.js untuk pemeriksaan dan pengeditan otomatis (tautan invalid, pembaruan grup pengguna, penggantian teks di seluruh wiki, dan hal-hal lain)

Rutinitas

Catatan: situs web status osu-wiki menampilkan daftar semua artikel yang membutuhkan pemeliharaan, dikelompokkan berdasarkan kategori.

Wiki bergantung pada masukan dari komunitas osu!. Kamu dapat membantu pengelola dan kontributor lain dengan melakukan apa yang kamu bisa lakukan. Untuk informasi tentang cara melakukannya, baca panduan kontribusi. Jika suatu saat kamu merasa perlu bantuan, mintalah bantuan di channel #osu-wiki di server Discord osu!.

Terjemahan

Untuk daftar terjemahan dan kelengkapannya, lihat: status osu-wiki

osu! wiki dibaca oleh orang-orang dari seluruh dunia. Untuk membantu komunitas lokal kamu dan menarik pemain, mapper, modder, dan pengembang baru yang luar biasa ke dalam game, Kamu dapat menerjemahkan artikel bahasa Inggris, atau memperbarui terjemahan yang ada yang tertinggal. Periksa daftar bahasa yang didukung oleh osu! wiki, dan pastikan terjemahanmu mengikuti prinsip paritas konten. Jika kamu seorang pembicara yang fasih dan penulis berpengalaman, ambil topik utama seperti artikel tentang aturan atau kriteria ranking. Jika kamu baru memulai karir menulis kamu, pilih artikel kecil untuk menerima bantuan dan bimbingan dari pengulas dan penutur bahasa asli.

Terjemahan dapat digabungkan tanpa ulasan dari penutur bahasa asli jika sudah lebih dari dua minggu sejak tanggal pembuatannya.

Pengembangan rintisan

Untuk kemungkinan lingkup pekerjaan, lihat: Daftar rintisan yang ada (Bahasa Inggris)

Beberapa artikel dari osu! wiki belum lengkap dan mmeerlukan lebih banyak informasi. Artikel tersebut ditandai sebagai rintisan, yang berarti artikel tersebut cukup penting untuk ada sebagai halaman individual, tetapi akan diselesaikan nanti. Jika Anda sudah familiar dengan topik artikel tersebut, berkontribusi dan bagilah pengetahuanmu.

Tautan silang

Salah satu fitur utama wiki mana pun adalah konektivitas, artinya artikel merujuk ke halaman terkait, membantu pembaca tetap mengikuti arus topik tersebut. Untuk menghubungkan artikel, tambahkan tautan ke istilah yang disebutkan di tempat yang penting untuk pemahaman yang lebih baik tentang subjek tersebut. Tautkan ke masing-masing bagian artikel bila perlu, dan gunakan halaman disambiguasi untuk istilah umum.

Artikel Baru

osu! adalah lingkungan yang selalu berubah: komunitas membuat beatmap baru, menemukan cara baru untuk mengekspresikan diri, dan melakukan hal baru lainnya. Jika peristiwa atau istilah tertentu tidak tercakup, jangan ragu untuk menulis artikel tentangnya dan berkontribusi pada kumpulan pengetahuan global. Turnamen atau kontes baru? fitur baru osu!? Bagian yang tidak diketahui dari sebuah cerita? Manfaatkan keterampilan menulis kamu yang tajam dengan baik.

Pembaruan

Untuk kemungkinan cakupan pekerjaan, lihat: Daftar TODO yang tidak terlacak (Bahasa Inggris)

Artikel yang ada juga perlu pemeliharaan. Jika kamu menemukan kesalahan faktual, atau ada detail yang hilang, atau jika kamu hanya ingin menulis ulang/memperluas artikel sesuai dengan apa yang ada, majulah dan buat osu! wiki tempat yang lebih baik. Jika perubahan yang kamu rencanakan cukup besar atau signifikan, pastikan untuk membahasnya di saluran #osu-wiki, atau buka issue baru.