Dari Gagasan Ke Tulisan

Teman-teman saya yang berprofesi sebagai pengembang perangkat lunak bertanya ke saya:

Gimana cara kamu menulis artikel di blog mu?

Jaman dulu, menulis itu selalu melibatkan tiga media: tangan, pensil dan kertas. Kalau sekarang juga tiga media: tangan, keyboard dan layar.

Yang berbeda cuma bentuknya. Kalau dulu bentuknya fisik, kalau sekarang bentuknya maya.

Kembali ke pertanyaan teman-teman saya. Sebenarnya saya tidak punya resep rahasia seperti resep rahasia kraby patty.

Yang saya lakukan saat ini cuma menentukan judul, kemudian membuat draf kasar kira-kira mau bahas apa dalam bentuk daftar dan mulai merangkai kalimat.

Contoh, tempo lalu saya membuat tulisan tentang Web API untuk membagikan konten web. Saya bentuk draf seperti ini:

Draf:

- Jelasin apa yang dibutuhkan pengguna untuk membagikan konten web dari browser ke media lain? Jawabannya judul konten dan tautan (URL).
- Jelasin kondisi saat pengguna membagikan konten web di desktop dan mobile.
- Jelasin tentang web share API dan batasan web share API.
- Jelasin bagaimana cara mengatasi batasan web share API menggunakan clipboard API.
- Jelasin cara memberikan alert dalam bentuk snackbar saat berhasil membagikan konten di web.

Silakan menuju commit: docs: draft web api untuk membagikan konten web.

Kemudian kalau ada niat, baru saya jabarkan dalam bentuk paragraf di setiap butir daftar tersebut.

Saya juga menerapkan pemilihan kata (diksi) dan banyak membaca tulisan orang agar memperkaya kosa kata. Entah buku, cuitan, dan lain-lain.

Omong-omong, salah satu buku favorit saya adalah Happy Wednesday Wkwkwkwk karya Azrul Ananda.

Buku Happy Wednesday - Azrul Ananda

Dulu, keluarga saya berlangganan koran fisik Jawa Pos dan saya selalu menantikan tulisan bang Azrul di hari Rabu di kolom Happy Wednesday. ~

Kadang sebelum saya buka tulisan saya ke publik (internet). Saya coba baca dua sampai tiga kali dan meninggalkan tulisan yang sudah selesai saya tulis hingga saya siap membagikannya ke publik.

Siapa tahu ada salah tulisan atau alur cerita tidak nyambung.

Saya bukan orang yang pintar bercerita.

Di sisi lain, ada euforia tersendiri ketika saya membagikan tautan tulisan saya ke sosial media seperti Twitter. Mulai dari jumlah like, retweet dan jumlah orang yg membuka tautan tulisan saya.

Saya sangat mengapresiasi itu semua, khususnya bagi yg membuka tautan tulisan saya. Itu berarti bahwa mereka senang membaca dan ingin mengetahui apa isi tulisan saya.

Julia Evans, salah satu pengembang perangkat lunak wanita yang saya ikuti di Twitter menjelaskan konsep always write for 1 person.

Always write for 1 person

Always write for 1 person yang dimaksud Julia adalah menulis untuk diri sendiri. Yang mana diri sendiri itu adalah diri kita tiga tahun yang lalu atau teman baik yang kita kenal.

Catatan hadir agar kita tidak lupa ketika kita menghadapi situasi yg sama.

Tidak semua pengembang perangkat lunak bisa menjelaskan sesuatu yang ada di dalam kode dalam bentuk tulisan. Namun, kita bisa mencobanya dengan hal sederhana sebagai langkah awal.

Contoh pertama, misalnya kita punya suatu proyek di Github. Kita jelasin proyek itu kegunaannya buat apa, cara menjalankannya gimana dan pakai teknologi apa aja di README.md.

Ketika kita tidak menyentuh proyek itu selama tiga sampai enam bulan dan berkunjung lagi ke proyek itu, kita masih ingat ini buat apa dan cara menjalankannya seperti apa. Kenapa? Karena telah ditulis di file README.md.

Contoh kedua, dengan membuat blog pribadi. Dengan membuat blog, kita bisa menuangkan ide pribadi atau melampiaskan unek-unek yang ada di pikiran.

Jangan khawatir soal kosa kata dan salah kata. Mulai aja dulu dan lakukan lebih baik secara bertahap.

Saya lebih suka menuangkan ide ke tulisan dibandingkan ke rekaman video. Kalau tulisan saya salah, saya bisa perbaiki di tulisan yang salah itu. Kalau rekaman video, menurut saya merepotkan karena saya tidak mahir untuk editing video. Wkwkwkwk.

Ingat! Orang pertama yang akan membaca catatanmu adalah dirimu sendiri.

Happy Wednesday ~

Jika konten ini bermanfaat, silakan: