====== Kiat Penulisan ======

Berikut beberapa kiat tentang cara menulis halaman wiki yang baik.

===== Struktur halaman =====

  * Awali halaman Kamu dengan judul tingkat pertama yang bermakna.
  * Susun level judul pertama dalam urutan yang benar, bagian-bagian di level kedua harus dimulai dengan level judul kedua.
  * Bagi teks Kamu menjadi beberapa paragraf dengan menyisakan baris kosong di antaranya. Rata-rata, satu paragraf tidak boleh lebih dari 10-20 baris.
  * Jika teks Kamu lebih panjang dari beberapa (3-5) paragraf, pertimbangkan untuk membaginya menjadi [[sintaks|bagian]] dengan menambahkan level judul kedua hingga kelima.
  * Jika teks Kamu lebih panjang dari 2-3 halaman, letakkan abstrak singkat tentang isi halaman setelah judul pertama. Jika halaman Kamu jauh lebih panjang, pertimbangkan untuk membaginya menjadi beberapa halaman.
  * Jika Kamu memiliki banyak tautan ke halaman wiki lain atau sumber daya eksternal, tambahkan bagian khusus dengan referensi lebih lanjut lihat [[#referensi|di bawah]].
  * Jika sebagian besar halaman dalam suatu [[namespace]] memiliki struktur yang sama, tambahkan [[namespace ]] template agar setiap halaman baru dapat dimulai dengan struktur kerangka tersebut.
  * Usahakan untuk menghindari struktur namespace yang terlalu rumit. Usahakan untuk menggunakan nama namespace yang singkat dan mudah diingat.

===== Pemformatan Teks =====

  * Tekankan kata tunggal atau bagian teks pendek dengan menggunakan **tebal** atau //miring//. Pilih salah satunya dan tetaplah pada pilihan Kamu.
  * Pilih gaya untuk menampilkan output layar dan teks di layar seperti tombol atau label menu dan gunakan secara konsisten. Mungkin ada baiknya menambahkan halaman dengan penjelasan tentang konvensi gaya Kamu ke wiki Kamu.
  * Gunakan [[sintaks#daftar tidak berurutan]] untuk pernyataan yang saling independen. Jika Kamu mengembangkan alur pemikiran, tulis dalam urutan kalimat yang berkelanjutan.
  * Gunakan [[sintaks#catatan kaki]] secukupnya dan hanya untuk catatan tambahan yang sangat singkat. Jika ada lebih banyak hal yang perlu dikatakan tentang topik tertentu, letakkan di halaman wiki baru. Jika Kamu ingin merujuk ke sumber informasi lain (eksternal), gunakan [[sintaks|tautan]] sebagai gantinya.
  * Tabel dapat sangat meningkatkan keterbacaan data terstruktur. Jika Kamu menyisipkan tabel, pastikan tabel tersebut memiliki judul sel yang bermakna dan berikan keterangan yang dengan jelas menyatakan isi tabel (misalnya, "Tabel 1.2: Jarak rata-rata antar planet").
  * Tabel yang besar cenderung sangat sulit diedit. Pertimbangkan untuk menyajikan datanya dalam daftar bersarang sebagai gantinya.

===== Bahasa =====

  * Tulis kalimat yang tepat dan gunakan kata sandang untuk kata benda jika perlu.
  * Mulailah setiap kalimat dengan huruf kapital dan akhiri dengan titik atau tanda baca lain yang sesuai.
  * Cobalah untuk menulis kalimat yang pendek dan jelas tanpa terlalu banyak menggunakan klausa subordinat. Setelah Kamu merasa halaman Kamu selesai, bacalah lagi dan revisi kalimat yang memiliki struktur terlalu rumit.
  * Tentukan cara Kamu menyapa pembaca. Karena WikiSuralaya ditujukan untuk penulisan dokumentasi, AKamu seringkali harus menginstruksikan pembaca Kamu tentang cara melakukan hal-hal tertentu. Kamu dapat menggunakan bentuk //imperatif// ("Lakukan ini!"), bentuk //kami/Kamu// ("Kemudian klik...") atau bentuk //saya// ("Saya kemudian menambahkan foo ke bar, menggunakan..."). Jangan mencampur bentuk-bentuk ini.
  * Periksa halaman Kamu untuk kesalahan tata bahasa atau ejaan sebelum menyimpannya. Jika teks Kamu menunjukkan banyak kesalahan, hal itu akan mengurangi kredibilitas pernyataan Kamu, terlepas dari seberapa matang pernyataan tersebut.
  * Kembangkan gaya Kamu sendiri. Jangan memaksakan diri untuk menulis dengan cara yang tidak Kamu sukai. Hal ini hanya akan terdengar tidak alami dan tidak menyenangkan untuk dibaca.

===== Referensi =====

  * Jika Kamu menemukan istilah yang membutuhkan penjelasan lebih lanjut, tambahkan halaman wiki baru untuk istilah tersebut dan tautkan ke halaman tersebut.
  * Periksa kembali halaman Kamu sebelum menyelesaikannya, dan tambahkan tautan ke halaman wiki yang sudah ada ke istilah utama halaman Kamu.
  * Jangan menambahkan tautan ke setiap kemunculan istilah tertentu. Jadikan kemunculan pertama/paling menonjol di halaman sebagai tautan dan mungkin tambahkan tautan ke bagian referensi.
  * Berikan tautan ke sumber gambar, data, dan kutipan.
  * Pertimbangkan untuk menambahkan baris "Lihat juga:" di akhir halaman Kamu. Berikan tautan ke halaman wiki yang //sangat// terkait dengan topik halaman Kamu di sana.
  * Jika Kamu ingin memberikan petunjuk ke sumber daya eksternal yang memiliki informasi lebih lanjut tentang topik Kamu atau yang Kamu gunakan dalam menulis halaman Kamu, tambahkan bagian yang disebut "Referensi" atau "Informasi lebih lanjut" di akhir dan berikan daftar tautan atau petunjuk lain (misalnya nomor ISBN). Jika Kamubelum melakukannya di teks utama, nyatakan tujuan referensi tersebut.
  * Mengatur pintasan [[interwiki]] dapat membantu dalam menghubungkan ke sumber daya umum.

===== Gambar dan media lainnya =====

  * "Sebuah gambar lebih bermakna daripada seribu kata." Bahkan mungkin lebih bermakna daripada yang Kamu maksudkan. ((Juga, Kamu tidak dapat mengekspresikan kutipan ini sebagai gambar, bukan?)) Manusia cenderung kurang mempertanyakan keaslian gambar dibandingkan dengan bahasa. Deskripsi tekstual singkat lebih baik daripada gambar yang tidak akurat.
  * Seperti halnya tabel, selalu berikan keterangan untuk gambar, yang menyatakan apa yang ingin Kamu tampilkan dengan gambar tersebut.
  * Jika Kamu tidak membuat gambar sendiri, sebutkan sumbernya (mungkin dengan tautan) dan hak ciptanya.
  * Jangan menautkan gambar dari situs eksternal, kecuali jika diizinkan secara eksplisit. Ini pertama-tama adalah masalah hak cipta tetapi juga dapat menjadi masalah pencurian bandwidth ketika //caching untuk gambar eksternal// dinonaktifkan.
  * Jika gambar lebih besar dari sekitar sepertiga halaman layar, gunakan [[sintaks|tautan dengan petunjuk pengubahan ukuran]] untuk menyisipkan gambar mini.