Prinsip untuk Menyelesaikan Technical Writing dengan Rapi

1. Gunakan gaya bahasa percakapan sehari-hari alih-alih nada yang terlalu formal.

2. Baca tulisan dengan suara keras, lalu periksa apakah terdengar seperti ucapan manusia sungguhan.

3. Pertimbangkan minat pengguna, karakteristiknya, tingkat pendidikan dan pengalamannya, waktu dan tempat saat membaca, serta lingkungan kerjanya.

4. Pilih dan berikan informasi yang kemungkinan ingin diketahui pengguna dan yang benar-benar mereka butuhkan.

5. Ingat bahwa tidak semua pengguna memahami produk dan teknologi terkait sebaik seorang ahli.

6. Setelah tulisan dipublikasikan, perbarui istilah, cara penggunaan, dan perubahan fitur tepat waktu.

7. Hindari kata keterangan yang tidak perlu, partikel yang berlebihan, dan bentuk bantu yang tidak penting.

8. Jangan gunakan ekspresi pasif ganda.
   Contoh: bentuk seperti pasif ganda perlu diubah menjadi bentuk pasif yang tepat.

9. Jangan tambahkan penanda jamak pada kata yang mengikuti 'beberapa/banyak/beragam/semua'.

10. Jika benar-benar harus menggunakan istilah teknis, jelaskan istilah tersebut di dalam tulisan.

11. Saat menulis untuk orang-orang di industri atau profesi tertentu, gunakan istilah yang relevan dengan industri atau profesi tersebut.

12. Setelah tulisan selesai, ambil jeda lalu baca kembali.

13. Jika menulis di desktop, baca kembali di smartphone atau tablet PC. Mencetaknya lalu membacanya juga bagus.

14. Baca tulisan dengan suara keras dan dengarkan bagaimana bunyinya.

15. Perbaiki kalimat yang sulit diucapkan atau terdengar janggal.

16. Tanyakan kepada reviewer apakah isi tulisan mudah dipahami, alurnya sudah baik, dan apakah ada hal yang perlu ditambahkan. Tidak masalah jika Anda mengajukan pertanyaan yang lebih spesifik tentang bagian yang memerlukan feedback.

17. Jika tulisan membahas fitur tertentu, uji apakah fitur itu benar-benar bekerja seperti yang dijelaskan.

18. Periksa apakah nama fitur atau menu, serta isi layar, sesuai dengan yang tertulis.

19. Gunakan pemeriksa ejaan untuk mengecek typo dan kesalahan spasi.
    Alat yang direkomendasikan: pemeriksa ejaan Pusan National University, pemeriksa ejaan Daum

20. Lihat contoh pedoman penulisan kata serapan dari National Institute of Korean Language untuk memeriksa kesalahan penulisan kata serapan.

[princox]

Masalah kesalahan penulisan kata serapan itu memang cukup besar,,
method, angel dan semacamnya itu dalam banyak kasus seharusnya ditulis berbeda sesuai kaidah.

Masalahnya, "ejaan yang salah" justru lebih sering dipakai dan bahkan SEO-nya juga lebih bagus.. situasinya benar-benar tidak masuk akal.

Jadi, yang mana yang benar..? hiks hiks hiks

[roxie]

Menurut saya, masalahnya adalah notasi yang tidak mampu mencerminkan realitas.

[ah2dius]

https://meetup.nhncloud.com/posts/355

Mungkin ini bukan jawaban yang pasti, tapi cukup layak untuk dijadikan referensi~

[princox]

Yang benar masing-masing muncul sebagai "metode" dan "Angel".
Selain itu, untuk object, di MS juga kadang dipadankan menjadi "objek"..

Memang technical writing itu benar-benar sulit.

[pugh123]

Terima kasih atas kontennya yang bagus.