Cara Menguji Sama Ada Artikel Menyelesaikan Masalah Pembaca

Tulis pernyataan permulaan audit sebelum menyemak prosa:

Pembaca: [jenis individu yang khusus]. Niat: [perkara yang ingin difahami atau diputuskan]. Tugasan: Selepas membaca, mereka boleh [tindakan yang boleh diperhatikan] tanpa memerlukan langkah atau sumber yang tidak disebut.

Contohnya:

Pembaca: Editor yang menyemak artikel web praktikal. Niat: Menentukan sama ada draf itu membantu pembaca sasarannya. Tugasan: Melaksanakan audit laluan penyelesaian dan merekodkan keputusan untuk menerbitkan, menyemak atau menolak, berserta sebabnya.

Perbezaan ini penting. “Belajar tentang kualiti kandungan” ialah topik maklumat, bukannya tugasan yang boleh diuji. “Kenal pasti prasyarat yang tiada dalam artikel panduan dan semak semula bahagian yang berkaitan” boleh diuji.

Pastikan skop cukup sempit supaya penyelesaian mempunyai titik akhir yang jelas. Panduan boleh menerangkan cara membandingkan dua produk, menyediakan dokumen, menyelesaikan masalah tetapan atau memilih antara beberapa pilihan. Panduan itu tidak perlu menjawab setiap soalan berkaitan untuk menyelesaikan tugasan yang dinyatakannya.

Panduan kandungan dan penerbitan GOV.UK mengesyorkan agar keperluan pengguna dikenal pasti dan kandungan dirancang berdasarkan keperluan tersebut. Soalan penilaian kendiri Google juga bertanya sama ada khalayak sasaran akan mendapati kandungan itu berguna, sama ada pembaca akan memperoleh maklumat yang mencukupi untuk mencapai matlamat mereka dan sama ada mereka akan mendapat pengalaman yang memuaskan (Google Search Central). Soalan ini berguna sebagai panduan, tetapi editor masih perlu menukarkannya menjadi ujian penyelesaian yang konkrit.

Senaraikan tindakan yang perlu dilakukan pembaca, mengikut urutan, untuk menyelesaikan tugasan. Sertakan keputusan, pengiraan, input, semakan dan serahan—bukan tajuk artikel sahaja.

Peta praktikal mungkin kelihatan seperti ini:

Kemudian tandakan setiap langkah sebagai diliputi, diliputi sebahagiannya atau tiada. “Diliputi” bermaksud pembaca boleh bertindak berdasarkan artikel itu, bukan sekadar topik tersebut disebut.

Contohnya, artikel tentang lembaran kerja belanjawan mungkin menerangkan cara menjumlahkan perbelanjaan tetapi tidak menyatakan tempoh masa yang perlu digunakan, sama ada cukai perlu dimasukkan dalam jumlah atau cara mengendalikan bil yang tidak tetap. Pengiraan utamanya ada, tetapi laluan penyelesaian terputus pada peringkat input.

Jadual audit yang berguna ialah:

Jadual ini menunjukkan sama ada draf itu lengkap sebagai alat. Jadual ini juga menghalang editor daripada memberikan markah tinggi kepada pengenalan yang kemas sambil terlepas pandang prasyarat yang tiada.

Banyak artikel praktikal gagal sebelum arahan pertama kerana mengandaikan pembaca mempunyai pengetahuan, akses atau keadaan tertentu yang sebenarnya tiada. Audit setiap langkah dengan mengajukan empat soalan:

Nyatakan andaian secara jelas. Jika pengiraan menggunakan peratusan, takrifkan asasnya. Jika panduan persediaan bergantung pada versi perisian tertentu, nyatakan versi atau ciri yang berkaitan. Jika artikel membandingkan beberapa pilihan, jelaskan keadaan yang menjadikan setiap pilihan sesuai.

Asingkan input yang wajib daripada penambahbaikan pilihan. Pembaca sepatutnya dapat mengetahui sama ada sesuatu perkara diperlukan untuk meneruskan atau sekadar membantu. Letakkan prasyarat sebelum prosedur supaya pembaca tidak membuang usaha.

Cari juga perubahan yang tersirat. Adakah pembaca perlu menukar unit, membuang ruang, memilih julat tarikh atau mentafsir mesej ralat? Jika ya, berikan peraturan atau contoh ringkas. Jangan mereka nilai secara senyap untuk input yang tiada. Beritahu pembaca perkara yang perlu diperoleh, andaian yang perlu didokumenkan atau keadaan yang menyebabkan kaedah itu tidak dapat diselesaikan.

Artikel lebih boleh dipercayai apabila menerangkan keadaan kegagalan dengan jelas. “Jika hasilnya kosong, periksa sama ada medan sumber telah diisi” lebih berguna daripada membayangkan bahawa kaedah itu sentiasa berhasil. Audit ini perlu merekodkan setiap titik yang munasabahnya boleh menyebabkan pembaca tersekat.

Bagi setiap dakwaan yang memberi kesan penting, tanyakan jenis sokongan yang diperlukan. Takrif mungkin memerlukan rujukan berautoriti. Arahan prosedur mungkin memerlukan manual pihak pertama atau spesifikasi yang didokumenkan. Syor mungkin memerlukan kriteria yang dinyatakan dan penjelasan yang jelas tentang cara kriteria tersebut membawa kepada syor itu.

Sediakan daftar dakwaan dengan empat lajur: dakwaan, keputusan pembaca yang terkesan, bukti yang digunakan dan kekuatan ungkapan. Lajur terakhir penting. Bukti mungkin menyokong “boleh”, “biasanya” atau “diperlukan”, tetapi tidak semestinya “sentiasa”, “terbaik” atau “terjamin”. Kekalkan syarat dan batasan daripada sumber.

Utamakan sumber asal atau sumber pihak pertama apabila sumber itu mendokumenkan perkara berkenaan. Contohnya, penjelasan W3C tentang Tahap Bacaan WCAG 2.2 menyatakan bahawa teks kompleks sepatutnya mempunyai versi yang lebih mudah difahami atau kandungan tambahan apabila tuntutan bacaan yang dinyatakan melebihi tahap tertentu. Editor boleh menggunakan sumber itu untuk mewajarkan semakan kerumitan, sambil mengelakkan kesimpulan tanpa sokongan bahawa satu skor kebolehbacaan menjadikan setiap artikel mudah diakses.

Bukti sepatutnya diletakkan berdekatan dengan dakwaan yang disokongnya, seperti dalam contoh itu, bukannya dalam senarai sumber yang tidak berkaitan. Senarai sumber berguna untuk semakan, tetapi tidak dapat membaiki perenggan yang ungkapannya melampaui bukti. Semak tarikh, versi dan skop, terutamanya untuk arahan yang berkaitan dengan perisian, piawaian atau dasar.

Artikel yang mudah dibaca bukan sekadar menyenangkan; artikel itu mengurangkan usaha yang diperlukan untuk mencari, memahami dan menggunakan arahan. Semak draf ketika ia digunakan:

Panduan W3C menjelaskan bahawa perkataan yang pendek dan lazim serta ayat yang lebih pendek secara umumnya lebih mudah difahami, sambil menyatakan bahawa perkara yang kompleks mungkin sesuai untuk khalayak khusus. Ini bermakna penyuntingan perlu mengurangkan kesukaran yang boleh dielakkan tanpa membuang ketepatan yang diperlukan. Jangan permudahkan sehingga syarat yang mengubah hasil terhapus.

Gunakan jadual untuk perbandingan berulang, senarai bernombor untuk urutan dan perenggan pendek untuk penaakulan. Jika sesuatu langkah memerlukan keputusan, letakkan syarat sejurus sebelum tindakan. Jika sesuatu istilah tidak dapat dielakkan, takrifkannya ketika mula-mula digunakan dan gunakan istilah yang sama selepas itu.

Baca artikel sekali sebagai pembaca sepintas lalu dan sekali sebagai pelaksana. Pembaca sepintas lalu sepatutnya dapat mengenal pasti hasil yang dijanjikan, prasyarat dan laluan kepada jawapan. Pelaksana sepatutnya dapat melakukan langkah-langkah itu tanpa perlu menyusun semula urutan yang dimaksudkan oleh penulis.

Semakan prapenerbitan yang paling kukuh ialah ujian tugasan ringkas dengan seseorang yang menyerupai pembaca sasaran tetapi tidak menulis draf itu. Berikan mereka pernyataan tugasan dan artikel tersebut. Minta mereka melakukannya secara berdikari sambil hanya menyebut tempat yang sedang dicari atau perkara yang diperlukan—bukan sama ada mereka menyukai artikel itu.

Perhatikan sama ada mereka:

Rekodkan titik kesukaran yang tepat: medan yang tiada, label yang samar, syarat yang terlepas, hasil yang tidak diterangkan atau kebergantungan luaran. Jangan anggap tekaan pembaca yang betul sebagai bukti bahawa artikel itu jelas. Tanya, “Apakah dalam artikel ini yang memberitahu anda supaya berbuat demikian?” Jika jawapannya ialah “Saya memang sudah tahu,” draf itu mungkin masih mempunyai jurang.

Selepas ujian, kelaskan setiap isu sebagai penghalang, melambatkan atau kosmetik. Baiki isu penghalang terlebih dahulu: prasyarat yang tiada, kekaburan yang tidak selamat, urutan yang salah dan laluan pengecualian yang tiada. Kemudian uji semula laluan yang telah diubah. Ujian pembaca tidak membuktikan kegunaan untuk semua orang, tetapi ujian itu boleh menunjukkan sama ada seseorang selain penulis mampu melaksanakan tugasan yang dinyatakan.

Analitik boleh menunjukkan perkara yang berlaku selepas penerbitan—seperti lawatan, carian, keluar atau interaksi—tetapi dengan sendirinya tidak membuktikan bahawa pembaca menyelesaikan tugasan. Lawatan singkat mungkin bermakna jawapan ditemui dengan cepat; lawatan yang lama mungkin bermakna pembaca keliru. Anggap data tingkah laku sebagai dorongan untuk menyiasat, bukan sebagai pengganti audit laluan penyelesaian.

Jika data tersedia, kaitkannya dengan hipotesis khusus: “Pembaca mungkin tidak menemui prasyarat,” atau “Cabang penyelesaian masalah mungkin tidak jelas.” Periksa bahagian yang berkaitan, ulangi ujian tugasan dan buat semakan hanya apabila bukti menyokong perubahan itu. Elakkan menjadikan metrik sebagai dakwaan tentang kegunaan tanpa memerhatikan atau mengesahkan hasil pembaca dengan cara lain.

Panduan Google yang mengutamakan pengguna meminta pencipta menilai kualiti kandungan, sumber, kelengkapan dan sama ada pembaca mencapai matlamat mereka. Soalan tersebut selaras dengan audit ini, tetapi tiada dokumen sistem carian yang dapat mengesahkan bahawa draf tertentu menyelesaikan tugasan seseorang. Keputusan editorial tetap berasaskan draf, buktinya dan laluan yang diperhatikan.