Beranda
Meng-gaya bebaskan dokumentasi
Tldr
Dihalaman ini menjelaskan tentang Apa, Mengapa, dan Tujuan dari situs ini.
Apa itu rtfm.id?
RTFM adalah sebuah singkatan dari Read The Fucking Manual yang mana sebuah jawaban untuk seseorang yang bertanya seputar pertanyaan yang, well, stupid question.
Yang maksudnya, sebuah pertanyaan yang sebenarnya jawabannya sudah ada di petunjuk.
Misal seperti kita membeli handphone baru, iPhone. Biasanya kita diberi buku petunjuk tentang penggunaan handphone tersebut. Lalu pertanyaan yang bodoh tersebut adalah seperti ini: Bagaimana cara memasukkan kartu sim di iPhone?
Yang jelas-jelas sudah ada caranya di buku manual tersebut.
Lalu untuk apa buku petunjuk tersebut dibuat bila tidak untuk dibaca?
Situs ini didedikasikan untuk mendokumentasikan pertanyaan-pertanyaan seputar Programming, khususnya JavaScript dan Frontend. Tidak hanya "answering the stupid question" saja, namun akan diisi pula tips & trik seputar itu.
Mengapa orang malas membaca manual?
Sebenarnya tidak semua orang malas membaca manual, kecuali orang-orang yang ingin sesuatu secara
instan, khususnya jawaban akan pertanyaan mereka. Misal, bila mereka mendapatkan pertanyaan:
Bagaimana cara membuat Promise di JavaScript?, mereka lebih suka langsung menanyakannya
(biasanya ke komunitas) daripada harus membaca manualnya dengan alasan ribet.
Ada juga yang malas membaca manual karena membosankan. Manual rata-rata ditulis menggunakan bahasa formal, baku, dan ya: Rata-rata bahasa Inggris. Maka dari itu kita membuat situs ini untuk menyajikan suatu informasi yang bersumber dari manual (dan, well: spesifikasi) ditulis ulang menggunakan bahasa gaya bebas alias bahasa sehari-sehari beserta link referensi tersebut (ke the boring content).
Fitur
Ada 6 fitur utama yang ditawarkan di situs ini, yakni: Dikelola komunitas, Bergaya bebas, Eksplisitas, Ber-bahasa Indonesia, Bersumber terbuka, dan Gratis.
Dikelola Komunitas
Maksud dari dikelola komunitas adalah siapa saja bisa berkontribusi disini. Misal, jika kalian suka membuka W3schools apa yang bisa kalian lakukan selain membacanya? Disini, selain kalian bisa membacanya juga bisa membantu mengembangkan; Mengubah, dan menjadikannya lebih baik!
Jika terdapat typo (menganggu) atau kesalahan penjelasan (fatal), kalian bisa bantu untuk mengubahnya daripada hanya melakukan sesuatu yang kurang bermanfaat dan kurang produktif :)
Bergaya Bebas
Because being boring is boring. Berdasarkan hasil observasi kami, menggunakan bahasa sehari-hari lebih mudah dipahami dibanding menggunakan bahasa baku. Juga, mengilustrasikan sesuatu yang abstrak–programming–menggunakan ilustrasi yang abstrak juga suatu hal yang membingungkan.
Seperti mengilustrasikan struktur data stack dengan, well, sebuah kotak, panah, dan tulisan yang mana membuat pertanyaan sepintas yang muncul di fikiran gue adalah: "Ngapain gue belajar ginian dah?".
Coba bedakan dengan ilustrasi didunia nyata, misal seperti browsing. Buka link ini ke link ini, ke link ini, terus pencet tombol back, diarahkan ke halaman sebelumnya, dsb. Misalnya. Gue yakin pasti lumayan mudah dipahami baik ilustrasi dasar & sebagain contoh penggunaan nya didunia nyata.
Juga, menggunakan bahasa sehari-hari bisa memberikan kesan bahwa "hey, we are your friend. Not your teacher. Feels free to ask, deny, and give a feedback if you have".
Eksplisit
Siapa yang suka sesuatu yang bertele-tele? Seperti, jika kita nanya tentang bagaimana cara membuat
Promise di JavaScript, maka informasi yang didapat ya tentang cara membuat Promise tersebut.
Dengan catatan, di bagian tldr.
Well, kita sebenarnya kurang suka dengan orang-orang yang terburu-buru seperti itu. Tapi, whatever.
Kita tetap memberikan penjelasan panjangnya demi mengikuti penjelasan yang sudah ada di spesifikasi.
Dan tetap memberikan tldr nya demi memenuhi keterburu-buruan kalian. Dengan harapan, membaca versi
detailnya ketika sudah memiliki waktu senggang.
Ketika senja misalnya.
Bahasa Indonesia
Cool! Meskipun enggak 100% bahasa Indonesia, campur-campur dengan bahasa Inggris juga dikit. Mungkin ada bahasa sunda dan jawa juga. Yang penting mudah dipahami.
Dan bukan dari hasil translate per-kata kunci :)
Sumber Terbuka
Open Knowledge. Open Source. Dan yes: Transparansi.
The root of healthy community.
Gratis
No registration. No account required. Just free as in beer.
Spread the love!
Jika kamu merasa informasi-informasi disini berguna, dan orang lain harus tau, sebarkan di sosial media! Kasih tau juga didunia nyata ke teman kerjamu, temanmu, sodaramu, gebetanmu, dosenmu, dosenku juga boleh deh tentang situs ini.
Dan ya, jika merasa situs ini kurang berguna, saya yakin kamu tau apa yang harus kamu lakukan untuk membuatnya setidaknya menjadi sedikit berguna.
