Glosarium berguna ketika pembaca mengenali sebuah kata tetapi belum memahami artinya dalam pekerjaan yang sedang dilakukan. Mengumpulkan banyak definisi kamus belum tentu menyelesaikan masalah itu. Kita perlu menjelaskan konteks, contoh, dan perbedaan istilah yang mudah tertukar.
Saya menyarankan memulai dari beberapa istilah yang benar-benar menghambat pemahaman artikel atau produk. Hasil akhirnya adalah tempat rujukan yang konsisten, bukan sejumlah halaman pendek yang hanya berbeda keyword.
Untuk bahasa campuran, pemetaan istilah Indonesia dan Inggris membantu menentukan padanan yang dipakai. Glosarium melanjutkan pekerjaan itu dengan penjelasan yang bisa dibaca pembaca secara mandiri.
Kumpulkan istilah dari titik kebingungan
Baca pertanyaan bantuan, catatan penyuntingan, atau hasil uji pembaca yang boleh digunakan. Catat kata persis yang membuat orang berhenti, konteks kemunculannya, dan tindakan yang tertunda.
Contoh ilustratif untuk website percetakan: pembaca memahami ukuran kertas tetapi bingung membedakan ukuran jadi, bleed, dan area aman. Memasukkan “kertas” ke glosarium mungkin kurang mendesak dibanding menjelaskan tiga istilah tersebut.
Jangan menganggap semua istilah industri perlu halaman. Sebagian cukup dijelaskan pada penyebutan pertama. Glosarium lebih berguna jika istilah muncul berulang, mempunyai arti khusus, atau memerlukan pembeda yang konsisten di beberapa panduan.
| Istilah calon | Kebingungan yang diamati | Bantuan yang diperlukan |
|---|---|---|
| Ukuran jadi | Disamakan dengan ukuran berkas desain | Batas hasil setelah pemotongan |
| Bleed | Dianggap ruang kosong wajib | Contoh latar yang melewati garis potong |
| Area aman | Dianggap sama dengan bleed | Posisi teks penting di dalam batas pemotongan |
Tabel ini contoh pemilihan istilah, bukan bukti bahwa semua pelanggan percetakan mempunyai kebingungan yang sama.
Pakai pola entri yang menjelaskan perbedaan
Satu entri dapat memuat istilah utama, definisi kontekstual, contoh, hal yang sering tertukar, dan langkah lanjutan. Tidak semua entri memerlukan panjang yang sama.
Contoh entri ilustratif:
Bleed dalam desain cetak adalah bagian desain yang diperpanjang melewati batas ukuran jadi untuk mengantisipasi sedikit pergeseran saat pemotongan. Jika latar harus mencapai tepi, latar tersebut diteruskan ke area bleed. Bleed berbeda dari area aman, tempat teks penting dijauhkan dari batas potong. Ukuran bleed mengikuti spesifikasi percetakan yang digunakan.
Definisi itu menjelaskan fungsi tanpa menetapkan angka universal. Menambahkan “selalu tiga milimeter” akan mengubah penjelasan menjadi instruksi yang belum tentu sesuai seluruh penyedia.
Periksa apakah definisinya berputar. “Area aman adalah area yang aman untuk desain” belum menjelaskan apa pun. Tunjukkan benda yang ditempatkan, batas yang dipakai, dan akibat jika salah memahami istilah.
Bedakan sinonim, singkatan, dan konsep terkait
Sinonim dapat menuju satu entri utama. Singkatan perlu dikembangkan. Konsep terkait memerlukan hubungan yang jelas, bukan dianggap sama.
| Hubungan | Cara menyajikan |
|---|---|
| Dua nama untuk konsep sama | Satu definisi utama dengan alias yang bisa ditemukan |
| Singkatan | Bentuk lengkap dan konteks pemakaian |
| Istilah sama, arti berbeda | Keterangan bidang atau penggunaan yang membedakan |
| Konsep terkait | Tautan dengan penjelasan perbedaannya |
Jangan menulis ulang definisi untuk tiap alias. Dua versi yang awalnya sama dapat berubah berbeda ketika editor hanya memperbarui salah satunya. Simpan satu pemilik definisi dan arahkan alias ke tempat tersebut.
Jika istilah berubah menurut produk atau standar, sebutkan versinya. Definisi umum dan label fitur milik vendor tidak selalu dapat dipertukarkan.
Pilih bentuk halaman berdasarkan kebutuhan
Glosarium pendek bisa berada pada satu halaman dengan daftar alfabetis dan tautan menuju setiap entri. Istilah dapat pula dikelompokkan menurut tugas, misalnya menyiapkan berkas, memilih bahan, dan memeriksa hasil cetak.
Halaman mandiri layak ketika satu istilah membutuhkan contoh, diagram, perbandingan, atau prosedur yang substansial. Pertanyaan “apa artinya?” dan “bagaimana menerapkannya?” mungkin tetap lebih jelas pada satu halaman jika pembahasannya singkat dan saling bergantung.
W3C memberi glosarium dan tautan menuju definisi sebagai cara membantu pengguna memahami jargon atau makna khusus. Panduan tersebut membahas keterpahaman dan aksesibilitas; keberadaan glosarium sendiri tidak menjamin peringkat pencarian. Penjelasan W3C tentang istilah yang tidak umum.
Tautkan dari tempat pembaca membutuhkannya
Letakkan bantuan dekat penggunaan istilah yang berpotensi membingungkan. Jangan memaksa pembaca mencari menu glosarium setelah tersandung sebuah kata di tengah tutorial.
Tautan sebaiknya menuju entri yang tepat. Jika membuka halaman panjang hanya di bagian paling atas, pengguna masih harus mencari ulang. Pastikan tautan ke bagian tetap berfungsi setelah judul entri berubah.
Berikan penjelasan singkat di artikel jika pemahamannya diperlukan untuk mengikuti langkah berikutnya. Tautan glosarium menambah kedalaman; ia tidak harus menggantikan seluruh konteks pada halaman asal.
Uji pemahaman dan siapkan pemeliharaan
Minta pembaca menjelaskan perbedaan dua istilah dengan contoh baru. Untuk contoh percetakan, tunjukkan posisi teks dan latar pada rancangan sederhana, lalu minta ia menunjukkan mana yang berkaitan dengan bleed dan area aman.
Jika ia hanya dapat mengulang definisi, tambahkan contoh atau pembeda. Jika ia memilih posisi yang salah, periksa kemungkinan definisi terlalu abstrak. Pengujian ini menilai kegunaan penjelasan, bukan pengetahuan seluruh audiens dari satu peserta.
Simpan catatan untuk setiap entri: pemilik, sumber definisi bila diperlukan, versi produk atau konteks, artikel yang merujuknya, dan pemicu pembaruan. Saat definisi berubah, periksa halaman yang bergantung padanya.
Glosarium selesai ketika istilah dapat ditemukan, dibedakan, dan dipakai untuk memahami tugas. Mulai dari satu kelompok istilah yang saling terkait. Tambah entri berikutnya ketika ada kebutuhan yang jelas, bukan untuk memenuhi jumlah istilah pada judul.
