Cara Membuat Pertanyaan yang Baik

Kami dengan senang hati membantu Anda, namun untuk meningkatkan peluang Anda mendapatkan jawaban, kami memiliki standar kualitas pertanyaan yang tinggi, pertanyaan-pertanyaan yang buruk mungkin akan dihapus.

Ini tidak hanya berlaku di Takode atau situs lain, didunia nyata ketika bertanya kepada rekan kerja tentang masalah pemrograman, Anda harus memiliki pertanyaan jelas dan dapat dipahami, jangan berasumsi mereka tahu segalanya seperti dukun, Anda tetap harus menjelaskannya secara detail ketika bertanya.

Berikut beberapa panduan yang perlu diikuti:

Pastikan Pertanyaan Sesuai Topik

Takode hanya menerima jenis pertanyaan tertentu tentang pemrograman dan pengembangan perangkat lunak. Jika pertanyaan Anda tidak sesuai topik atau tidak cocok untuk situs ini, kemungkinan besar pertanyaan tersebut akan ditutup.

Penutupan bukanlah akhir dari pertanyaan, ini dimaksudkan sebagai keadaan sementara sampai pertanyaan tersebut direvisi untuk memenuhi persyaratan kami. Namun, jika Anda gagal melakukannya, atau tidak mungkin melakukannya, maka pertanyaannya akan tetap tertutup tidak akan terjawab, dan mungkin akan dihapus.

Karena Anda membaca halaman ini, semoga Anda dapat memposting pertanyaan yang sesuai dengan topik sejak awal, sehingga menghilangkan kebutuhan akan proses penutupan dan pembukaan kembali!

Cari Pertanyaan Sebelum Membuat

Sebelum memposting pertanyaan, kami sangat menyarankan agar Anda meluangkan waktu yang wajar untuk meneliti masalah dan mencari pertanyaan yang ada di situs ini yang mungkin dapat memberikan jawabannya.

Pastikan untuk terus memantau apa yang Anda temukan saat melakukan penelitian, meskipun itu tidak membantu! Jika pada akhirnya Anda tidak dapat menemukan jawaban atas pertanyaan Anda di tempat lain di situs ini, maka menyertakan tautan ke pertanyaan terkait (serta penjelasan mengapa pertanyaan tersebut tidak membantu dalam kasus spesifik Anda) akan membantu mencegah pertanyaan Anda ditandai sebagai duplikat.

Jika fitur pencarian yang disediakan di situs ini tidak cukup membantu, tulis pertanyaan Anda di Google dan akhiri dengan site:takode.com, contoh cara mengubah nama branch git site:takode.com, perintah ini akan mencari pertanyaan terkait "cara mengubah nama branch git" hanya di Takode.

Tulis judul yang Spesifik dan Merangkum Masalah

Judul adalah hal pertama yang akan dilihat oleh calon penjawab. Jika judul Anda tidak menarik atau tidak jelas, jangankan untuk dijawab, orang mungkin tidak akan membacanya. Selain itu, tanpa judul yang bagus, orang mungkin tidak dapat menemukan pertanyaan Anda. Jadi, buatlah judul yang deskriptif dan spesifik, buat lah orang memahami pertanyaan Anda hanya dengan membaca judul.

Anggaplah Anda sedang berbicara dengan rekan kerja yang sibuk dan harus merangkum seluruh pertanyaan Anda dalam satu kalimat: detail apa yang dapat Anda sertakan yang akan membantu seseorang mengidentifikasi dan memecahkan masalah Anda? Sertakan pesan kesalahan, atau keadaan tidak biasa yang membuat pertanyaan Anda berbeda dari pertanyaan serupa yang sudah ada di situs.

Jika Anda kesulitan meringkas masalahnya ke dalam sebuah judul, tulislah judulnya di bagian terakhir, terkadang menulis isi pertanyaan lebih awal dapat mempermudah dalam menjelaskan masalahnya.

Contoh:

  • Buruk: Bingung dengan Matematika di C#
  • Bagus: Mengapa menggunakan float daripada int memberi saya hasil yang berbeda ketika semua input saya bilangan bulat?
  • Buruk: Menggunankan sesi [php].
  • Bagus: Bagaimana cara mengarahkan pengguna ke halaman berbeda berdasarkan data sesi di PHP?

Manfaatkan batas panjang judul semaksimal mungkin, hindari kata-kata yang tidak perlu, lebih baik singkat tapi to the point daripada panjang tapi bertele-tele, contoh:

  • Buruk: Halo Teman-teman Selamat Pagi Saya Mendapatkan Error di Laravel Bagaimana Cara Mengatasinya Ya?
  • Bagus: Bagaimana Cara Mengatasi Error "Access denied for user 'user'@'localhost'" di Laravel?

Jika Anda mendapatkan pesan kesalahan, salin hanya sebagian pesan kesalahan yang spesifik dan sertakan di dalam judul, ini dapat memberitahu orang kesalahan apa yang Anda dapatkan, jangan menyalin mentah semua pesan kesalahan.

Jelaskan Masalah Sebelum Menyertakan Kode

Di dalam isi pertanyaan Anda, mulailah dengan membuat ringkasan yang Anda masukkan ke dalam judul. Jangan langsung langsung menulis kodenya! Memberikan beberapa informasi kontekstual latar belakang sering kali membantu, dan mendeskripsikan masalah Anda dengan kata-kata hampir sama pentingnya dengan mendeskripsikannya dengan kode.

Jelaskan bagaimana Anda menghadapi masalah yang ingin Anda selesaikan, dan kesulitan apa pun yang menghalangi Anda untuk menyelesaikannya sendiri. Paragraf pertama dalam isi pertanyaan Anda adalah hal kedua yang akan dilihat sebagian besar pembaca, jadi buatlah paragraf semenarik dan seinformatif mungkin.

Bantu Orang Mereproduksi Masalahnya

Tidak semua pertanyaan mendapat manfaat dari penyertaan kode, tetapi jika masalah Anda ada pada kode yang Anda tulis, Anda harus menyertakan kode. Tapi jangan hanya menyalin seluruh kode program Anda! Hal ini tidak hanya akan membuat Anda mendapat masalah jika Anda memposting kode perusahaan Anda, tetapi juga mungkin berisi banyak detail tidak relevan yang perlu diabaikan oleh pembaca saat mencoba mereproduksi masalah tersebut.

Berikut beberapa pedomannya:

  • Sertakan kode secukupnya agar orang lain dapat mereproduksi masalah tersebut.
  • Jika memungkinkan untuk membuat contoh langsung dari masalah yang dapat Anda tautkan (misalnya, di CodeSanbox atau StackBlitz), tapi jangan hanya menyertakan tautan, salin kode dan jelaskan pertanyaannya ke dalam isi, karena tidak semua orang dapat mengakses situs eksternal, dan tautannya mungkin rusak dimasa depan.
  • JANGAN memposting gambar kode, data, pesan kesalahan, dll. - Anda harus menyalin pertanyaan atau mengetik pertanyaan bukan gambar screenshot.

Sertakan semua tag yang relevan

Ingatlah untuk hanya menyertakan tag yang relevan, minimal 1, maksimal 5. Lebih baik 1 tag spesifik daripada banyak tag tapi tidak relevan dengan pertanyaan.

Cobalah untuk menyertakan tag untuk bahasa, perpustakaan, dan API spesifik yang menjadi pertanyaan Anda. Jika Anda mulai mengetik di bidang tag, sistem akan menyarankan tag yang cocok dengan apa yang Anda ketik, pastikan untuk membaca deskripsinya untuk memastikan tag tersebut relevan dengan pertanyaan Anda.

Koreksi Sebelum Dikirim

Sekarang setelah Anda selesai menulis pertanyaan Anda, tarik napas dalam-dalam dan bacalah dari awal sampai akhir. Anggaplah Anda baru pertama kali melihatnya: lalu tanyakan pada diri Anda apakah masuk akal? Bisakah seseorang tanpa konteks dan latar belakang pengetahuan Anda memahaminya?

Cobalah mereproduksi masalahnya sendiri, di lingkungan yang baru dan pastikan Anda dapat melakukannya hanya dengan menggunakan informasi yang disertakan dalam pertanyaan Anda. Tambahkan detail apa pun yang Anda lewatkan dan baca lagi. Baca kembali judul Anda, dan pastikan judul tersebut menjelaskan masalahnya secara ringkas dan akurat.

Selain itu, ejaan, tata bahasa, kapitalisasi huruf, dan tanda baca juga penting!

Tanggapi Jawaban dan Komentar setelah Dikirim

Setelah Anda mengirimnya, periksa pertanyaan secara berkala untuk melihat apakah ada yang berkomentar. Jika Anda mendapatkan umpan balik yang membantu memperbaiki pertanyaan, bersiaplah untuk merespons dengan mengedit pertanyaan Anda. Jika seseorang memposting jawaban, bersiaplah untuk mencobanya dan berikan masukan!

Terkadang, Anda mungkin merasa frustrasi dengan komentar tersebut. Mungkin mereka memberikan saran yang sudah Anda coba, atau bahkan mungkin mereka salah memahami masalah Anda.

Cobalah untuk tidak frustrasi, orang yang membaca dan mengomentari pertanyaan Anda biasanya ingin membantu! Anggaplah komentar semacam ini sebagai saran tentang cara memperbaiki pertanyaan Anda. Ingatlah bahwa Anda dapat mengedit pertanyaan Anda kapan saja! (Jika seseorang meninggalkan komentar yang kasar atau tidak relevan, tandai komentar tersebut agar mendapat perhatian moderator sehingga komentar tersebut dapat dihapus.)

Jangan lupa untuk menandai jawaban sebagai jawaban yang diterima sebagai apresiasi kepada pengguna yang telah membantu Anda. Jika Anda mendapatkan jawaban yang membantu tapi kurang puas berikan up vote, dan jangan ragu untuk memberikan down vote jika Anda mendapatkan jawaban yang salah atau tidak relevan.

Sistem voting ini dapat membantu orang-orang yang mengalami masalah yang sama mendapatkan solusi yang benar.

Itu saja! Panduan ini dibuat tidak lain untuk membangun komunitas yang berkualitas yang dapat membantu programmer atau calon programmer dengan berbagai latar belakang pengetahun.