Id:Pedoman Wiki
Pedoman Wiki berikut harus diikuti saat menulis halaman wiki. Ini akan membantu menciptakan wiki yang bermanfaat dan mudah digunakan, yang dapat diakses oleh semua orang. WikiProject Cleanup adalah halaman yang mengoordinasikan pekerjaan di wiki untuk meningkatkan kesesuaian dengan pedoman ini.
Kemudahan dipahami
Buat halaman tetap pendek, gunakan bahasa yang sederhana, dan hindari terminologi teknis. OpenStreetMap bertujuan agar dapat diakses oleh semua orang, dan dokumentasi kami harus mencerminkan hal ini. Arahkan tulisan Anda pada level anak-anak dan nenek!
Beberapa halaman wiki secara alami berbentuk dokumentasi teknis. Bahkan dalam hal ini, kami harus berusaha agar dapat dipahami oleh pengguna dengan berbagai kemampuan teknis. Tulis pengantar sederhana untuk memulai topik, dan pertimbangkan untuk memisahkan detail yang sangat rumit untuk memisahkan halaman wiki yang lebih terfokus.
Struktur
Wiki harus disusun sedemikian rupa sehingga orang dapat dengan mudah menemukan konten yang mereka cari mulai dari Halaman Utama. Beberapa konten utama ditautkan langsung dari Halaman Utama, tetapi tautan halaman utama lainnya membawa Anda ke 'halaman awal' pada topik tertentu. Tautan tersebut merupakan tingkat berikutnya dalam semacam hierarki navigasi. Tautan tersebut sering kali berupa halaman pendek dengan banyak tautan dan tidak terlalu banyak teks (juga dikenal sebagai 'portal'). Diperlukan upaya untuk memastikan bahwa navigasi ini masih berfungsi secara efektif bagi pengunjung baru.
Informasi yang saling bertentangan
Informasi yang saling bertentangan sangatlah buruk. Informasi tentang rekomendasi penandaan saat ini harus konsisten. Jika tidak demikian, silakan hubungi pengguna lain untuk mengembangkan konsensus. Rekomendasi penandaan idealnya harus sesuai dengan praktik penandaan yang sebenarnya, kecuali ada alasan yang sah untuk tidak melakukannya.
Proposal dan usulan perubahan penandaan merupakan pengecualian terhadap aturan ini. Namun, usulan tersebut harus diidentifikasi dengan jelas sebagai proposal.
Duplikasi
Duplikasi sering kali buruk karena berisiko memberikan informasi yang saling bertentangan dan menambah jumlah pekerjaan. Jika ada duplikasi yang tidak perlu, duplikasi tersebut harus dirasionalisasi untuk menyediakan satu sumber informasi yang jelas. Ini mungkin memerlukan diskusi dengan pengguna lain! Tidak masalah untuk meringkas topik di halaman lain, tetapi ringkasan tersebut akan ditautkan ke halaman utama.
Template:merge digunakan untuk memberi label pada halaman yang memerlukan penataan ulang untuk menghilangkan duplikasi.
Jika duplikasi bermanfaat (misalnya, disajikan dengan gaya, struktur halaman yang berbeda, atau untuk audiens yang berbeda), penting untuk menjelaskan alasannya, dan menautkannya untuk menghindari kebingungan. Jika tidak ada alasan yang tepat untuk duplikasi, maka halaman tersebut harus digabungkan. Perhatikan bahwa penggabungan tidak selalu berarti kita memiliki satu halaman padahal sebelumnya ada dua halaman. Ada hasil lain, misalnya halaman ringkasan non-teknis dapat ditautkan ke halaman teknis yang lebih terperinci.
Judul - Konvensi penamaan halaman
Silakan ikuti Konvensi penamaan kapitalisasi Wikipedia: Nama artikel mengikuti kapitalisasi kalimat (huruf kecil untuk kata non-nama), bukan kapitalisasi judul (huruf besar untuk huruf pertama setiap kata) ala KBBI. Hal ini dilakukan untuk memudahkan penulisan pranala di dalam suatu kalimat..
Jangan gunakan judul halaman CamelCase yang kata-katanya dijejalkan bersama tanpa spasi - MediaWiki memperbolehkan kita menggunakan spasi seperti dalam bahasa alami. Pengecualian untuk ini adalah jika judul halaman adalah nama sesuatu yang biasanya kata-katanya dijejalkan bersama, misalnya "OpenLayers"
Awalan dalam judul halaman telah banyak digunakan di masa lalu (misalnya awalan 'WikiProject'). Ini sebagian besar merupakan warisan yang merepotkan, tetapi bukan hal yang tidak dapat kita perbaiki dengan mudah pada tahap ini. Memindahkan semua halaman tersebut akan menjadi tugas yang sangat besar. Namun, membuat skema awalan judul halaman baru sangat tidak disarankan. Gunakan judul halaman dalam bahasa alami, dan buat tautan silang sekumpulan halaman untuk membuat struktur tautan dalam konten halaman itu sendiri. Silakan lihat Organisasi Wiki untuk diskusi terkini tentang topik ini.
Pendahuluan
Halaman harus dimulai dengan paragraf pengantar singkat yang terdiri dari beberapa kalimat. Ini harus menyertakan judul dalam huruf tebal dan menjelaskan tentang halaman tersebut. Sering kali berguna untuk menyertakan tautan ke halaman yang lebih umum dan ke halaman yang lebih spesifik, karena ini membantu navigasi.
Bagian pengantar ini harus muncul sebelum judul apa pun (dan sebelum Daftar Isi pada halaman yang panjang). Perhatikan bahwa cukup umum bagi orang untuk membuat judul pertama "Pendahuluan". Ini harus direstrukturisasi sehingga setidaknya sebagian dari pendahuluan berada di bagian atas halaman di atas judul apa pun. Ini akan mencapai tata letak yang konsisten di seluruh wiki.
Tautan
Halaman harus ditautkan dengan baik untuk membantu pengguna menemukan informasi yang mereka cari. Konsep penting yang terkait biasanya ditautkan dalam pendahuluan. Jika Anda tidak dapat memikirkan halaman wiki terkait untuk ditautkan dari sini, maka Anda mungkin tidak mendeskripsikan halaman tersebut dengan istilah yang cukup luas. Anda juga dianjurkan untuk menautkan ke konsep terkait di seluruh bagian halaman.
Menautkan bagian ke halaman utama
Kode {{main|nama halaman}} dapat digunakan di bawah judul bagian untuk menyediakan tautan ke halaman utama yang terkait dengan subjek bagian tersebut. Bagian tersebut kemudian hanya boleh meringkas halaman 'utama' yang ditautkan (dan tentu saja tidak boleh bertentangan dengannya dengan cara apa pun). Judul bagian tersebut biasanya harus sama dengan halaman yang ditautkan.
Menautkan dan memberi gaya pada kunci atau nilai
Sering kali, teks berisi kunci atau nilai terkait. Jika Anda menggunakan templat (dalam perangkat lunak wiki lain disebut "macro") Template:Tag (Key adalah alias), Template:Value dan terkait dengan mengetik sumber wiki {{Tag|highway|motorway}} atau menambahkannya menggunakan menu editor, teks akan muncul seperti highway=motorway yang memiliki beberapa keuntungan:
- Karena format yang terstandarisasi dan terkenal, teks dapat dikenali sebagai kunci=nilai pada pandangan pertama, sementara itu lebih sulit dengan teks biasa.
- Baik kunci maupun nilai masing-masing merupakan tautan tersendiri, sehingga memudahkan untuk menemukan informasi lebih lanjut.
- Ini adalah tautan internal, sehingga mengarahkan pengguna ke halaman dalam bahasa saat ini, tidak akan terputus meskipun URL berubah, dapat diikuti di kedua arah, dapat dianalisis untuk statistik, dll.
Penautan ke Wikipedia
Tautan Wikipedia bisa membingungkan. Tautkan ke Wikipedia hanya jika bermanfaat, dan jika konsepnya tidak dijelaskan dengan lebih baik dalam konteks OSM di wiki ini.
Jika menggunakan sintaks interwiki [[wikipedia:nama halaman]], harap biarkan awalan wikipedia: tetap ada, mis. Jangan gunakan teks tautan alternatif: [[wikipedia:page name|nama halaman]] karena ini sangat membingungkan dalam hal navigasi dasar. Namun, Anda dapat menggunakan templat untuk membuat tautan eksternal ke Wikipedia lebih eksplisit: {{Wikipedia|id|Nama halaman}}, atau {{Wikipedia|id|Nama halaman|text= no }} untuk tetap menggunakan ikon awal tanpa teks akhir "di Wikipedia".
Jangan menautkan ke halaman Wikipedia yang judulnya sama atau mirip ada di wiki ini (kecuali dari artikel di wiki ini, yang dapat digunakan sebagai referensi eksternal tambahan untuk informasi lebih lanjut tentang topik yang sama).
Halaman tentang situs web
Kami memiliki banyak halaman wiki yang didedikasikan untuk mendeskripsikan beberapa situs web eksternal (layanan peta, produk perangkat lunak, dsb.). Jelas tautan eksternal ke situs tersebut sangatlah penting. Tautan utama harus ditempatkan dalam tanda kurung setelah judul (yang ditulis dalam huruf tebal) di kalimat pertama dan/atau ditautkan dalam teks yang lebih besar pada barisnya sendiri setelah kalimat deskriptif teratas.
Pada halaman-halaman ini tidak ada gunanya menduplikasi banyak informasi 'tentang' yang ditemukan di situs eksternal. Halaman tersebut harus mendeskripsikan situs dalam konteks OSM. Bersikaplah lebih netral dan kurang promosional dengan deskripsi Anda, meskipun usahakan untuk menggunakan bahasa yang mempromosikan OSM dan penggunaan OSM.
Mencantumkan perangkat lunak/layanan
Kami memiliki sejumlah halaman yang berisi daftar poin-poin atau tabel wiki yang mencantumkan perangkat lunak/layanan. Jika kami memiliki halaman wiki tentang perangkat lunak, atau bahkan jika kami tidak memilikinya (tautan merah), format yang lebih disukai adalah tautan internal ke halaman wiki OSM diikuti oleh tautan eksternal ke situs dalam tanda kurung. Ini kemudian dapat diikuti oleh deskripsi singkat atau kolom tabel lainnya. Kami harus berusaha menyediakan tautan ke halaman wiki dan tautan eksternal bahkan jika halaman wiki tersebut belum ada untuk mendorong tingkat interkoneksi wiki yang sehat. Tautan merah dapat diisi dengan informasi rintisan mengikuti saran di atas.
Tautan eksternal URL lengkap dapat menjadi bagus, jika pendek, karena pengguna tahu apa yang diharapkan saat mereka mengekliknya. Teks tautan alternatif harus digunakan untuk mempersingkat ini, sebaiknya ke nama domain sehingga masih jelas bahwa ini adalah tautan eksternal. Contoh:
- OpenLayers (openlayers.org) - Pustaka JavaScript untuk menampilkan peta.
Dalam situasi yang sangat terbatas ruang (sering kali dalam kasus tabel wiki), kita dapat menggunakan sintaks tautan bernomor (misalnya [1]) untuk mengecilkan tautan eksternal. Kita dapat memilih untuk menghilangkan tautan eksternal dan hanya menautkan halaman wiki, karena halaman ini sendiri akan memiliki tautan eksternal. Jika halaman wiki tidak ada, kita mungkin memilih untuk hanya menyediakan tautan eksternal, tetapi mungkin lebih baik untuk membuat halaman wiki dengan deskripsi rintisan.
Kategori
Kategori harus digunakan untuk mengelompokkan halaman berdasarkan jenisnya, yang harus mengikuti konvensi penamaan yang sama seperti pada halaman wiki.
Kategori itu sendiri dapat dikategorikan untuk membuat hierarki guna membantu navigasi ke subjek yang diminati. Misalnya Category:Id:Bus dikategorikan dalam Category:Id:Angkutan umum.
Halaman dapat menjadi bagian dari sejumlah kategori, tetapi editor harus menghindari kategorisasi yang berlebihan. Halaman yang berkaitan dengan bus (misalnya, halaman tentang halte bus) harus dikategorikan sebagai 'Bus', tetapi tidak juga sebagai 'Angkutan umum'. Namun, halaman utama Bus harus diberi tag dalam kategori 'Angkutan umum' serta kategori yang lebih spesifik.
Pendahuluan satu baris harus disediakan untuk setiap kategori yang secara umum harus ditautkan ke halaman 'utama' yang sesuai untuk subjek tersebut, idealnya dengan nama yang sama. Misalnya Halaman yang berkaitan dengan [[Id:Angkutan umum]] sebagai pengantar untuk kategori 'Id:Angkutan umum'.
Saat dikategorikan, halaman harus menggunakan opsi urutan sortir jika perlu untuk memastikan bahwa halaman tersebut muncul dengan tepat dalam daftar halaman. Misalnya, lihat halaman yang tercantum dalam Category:User in London. Semuanya akan tercantum dalam 'U' karena awalan 'User:', tetapi ini telah diganti. Misalnya, User:Harry Wood memiliki teks wiki kategori: [[Category:Users in London|Harry Wood]] dengan frasa sortir yang disediakan setelah '|'.
Wiki ini menyediakan HotCat-Gadget, antarmuka sederhana untuk mengubah kategori.
Pemformatan tanggal
Tanggal harus diformat dalam salah satu cara berikut, tergantung pada ketepatan yang dibutuhkan:
- HH bulan TTTT (format normal, kecuali jika ada ketidakpastian atau jika hari tersebut sangat relevan; tidak perlu nol di awal nilai hari)
- Nama hari HH bulan TTTT (untuk saat hari dalam seminggu penting)
- bulan TTTT (hari dalam bulan tidak diketahui atau relevan)
- 2025-03-28 (format tetap dari standar ISO 8601, untuk digunakan dalam data tabular, terutama saat konten harus ditransklusikan ke beberapa halaman terjemahan; menyertakan bantalan kiri nol)
- 2025-03 (mirip saat hari dalam bulan tidak diketahui atau relevan)
- 2025 (hanya tahun, tanpa pemisah ribuan)
- 'Segera' (March 2025) (saat prediksi dibuat pada waktu tertentu waktu)
Akhiran ordinal (ke-) tidak diperlukan, dan hari serta bulan harus ditulis lengkap. Hindari tanggal yang tidak lengkap dan tidak jelas, dan hindari penggunaan musim (musim panas di belahan bumi utara adalah musim dingin di selatan!).