Apakah "komentar lucu" adalah praktik yang buruk atau tidak? [Tutup]


37

Saya ingin bertanya kepada Anda apakah menambahkan beberapa "telur paskah" dalam dokumentasi sumber tidak profesional atau tidak. Mungkin Anda memiliki membaca StackOverflow jajak pendapat untuk komentar lucu dalam sumber dokumentasi, dan saya secara pribadi telah tersandung di banyak hal-hal seperti selama saya bekerja, termasuk lucu (atau tidak) hal-hal dalam dokumentasi API publik (misalnya lemah ini BZZZTT !! 1! Hal dalam dokumentasi publik Android, saya dapat memberikan setidaknya selusin contoh lagi).

Saya tidak bisa sampai pada pendapat akhir untuk diri saya sendiri, karena saya sendiri memiliki argumen yang bertentangan.

Argumen pro:

  • Itu bisa menghibur seseorang, dan membuat harinya lebih lucu / lebih produktif. Sebagian besar kode sumber tidak perlu dikomentari pula (jika proyek dilakukan dengan benar), karena metode spesifik (misalnya) cukup jelas, atau jika itu adalah tumpukan kode jelek yang aneh, ia tidak bisa dijelaskan dengan cara yang bermakna, sehingga lelucon lucu tidak membahayakan info yang mungkin bisa Anda peroleh dari dokter.

Argumen kontra:

  • Jika Anda sangat terkonsentrasi / frustrasi, hal terakhir yang Anda butuhkan adalah lelucon bodoh seseorang, alih-alih memberi Anda informasi yang Anda butuhkan tentang bagian kode yang terdokumentasi, itu hanya dapat membuat Anda semakin frustrasi. Dan gagasan tentang bagaimana dokumentasi akan terlihat jika semua orang mulai melakukannya adalah mengerikan. Ditambah lagi lelaki yang menulis lelucon mungkin satu-satunya yang berpikir bahwa itu lucu / menarik / layak buang waktu untuk membacanya.

Apa yang kamu pikirkan?


Silakan baca FAQ dan panduan situs untuk mengajukan pertanyaan. Pertanyaan ini benar-benar tidak memenuhi pedoman itu.
Walter

8
@Walter: pertanyaannya hampir sama dengan programmers.stackexchange.com/questions/50928/… , tetapi untuk komentar lucu alih-alih komentar senonoh, dan pertanyaan yang ditautkan tidak ditutup, ditanyakan sebulan lalu. Saya tidak akan membuang waktu berdebat dengan Anda bahwa pertanyaan ini memenuhi FAQ, dan itu terkait dengan praktik terbaik (baik) saat menulis kode.
seseorang

2
7 suara, Q ini jelas diinginkan. Secara pribadi saya tidak yakin saya kesal dengan "penipu" yang telah Anda sebutkan berkali-kali tetapi saya bisa melihat argumen untuk "pro" jadi saya ingin tahu apa hasilnya. (Yang terburuk yang saya temui adalah seorang programmer yang mengira foto "lucu" dari senjata BB yang menunjuk pada anak kucing dengan cakarnya harus berada di halaman rumah semua server dev kami. Sigh ...)
James

@sombody - Anda benar, tetapi komentar lucu tidak akan membuat Anda dipecat atau lebih buruk, dikenakan gugatan pelecehan. Saya akan mempertimbangkan untuk menutup pertanyaan lainnya (Tidak yakin saya benar ketika diposting.).
JeffO

1
Saya setuju bahwa posting ini harus dibuka kembali, walaupun saya tidak dapat memilih karena saya tidak memiliki perwakilan. Inti membuat Pemrogram terpisah dari SO adalah untuk pertanyaan seperti ini. Ditambah dengan 22 suara untuk pertanyaan ini, jelas diinginkan oleh masyarakat.
RoboShop

Jawaban:


12

Saya pikir komentar lucu itu membuang waktu - buang waktu untuk menulis, buang waktu untuk membaca, buang waktu untuk menunjukkan kepada rekan kerja Anda komentar lucu yang (hampir selalu) hanya membingungkan dan sebagainya.

Tapi ... tidak ada yang benar-benar bekerja pada 100% sepanjang hari setiap hari (situs-situs seperti ini akan kosong jika kita lakukan) dan humor asli memecah hari dan membantu menjaga moral.

Saya masih akan menentangnya hanya karena setiap komentar 'lucu' yang pernah saya baca mungkin lucu pada saat itu - tetapi saya belum melihat satu yang benar-benar lucu, sebagian besar hanya membingungkan atau jauh di dalam hati. -lelucon.

Jika komentar lucu benar-benar lucu, itu akan mengubah pikiran saya. Tetapi begitu Anda mendorong lelucon, apakah Anda mendorong sumpah atau penghinaan atau kejahatan?


5
+1 Anda hanya membaca komentar itu ketika Anda harus memperbaiki sesuatu dan mereka tidak masuk akal saat itu dan ketika memperbaiki bug Anda tentu tidak ingin melihat beberapa 'lelucon pintar' pengembang lain tentang subjek. Alih-alih menghabiskan waktu untuk memikirkan lelucon, tolong, luangkan waktu untuk kode yang lebih jelas, perbaiki bug, dll. Juga, apa yang terjadi dengan 'lelucon' jika ada sesuatu yang refactored?
Jan_V

2
Jadi itu seperti humor di ruang angkasa: lebih baik menjadi lucu, dan lebih baik tidak menjadi SEMUA yang Anda lakukan.
Dan Ray

1
+1 pintar, asalkan tidak ada salahnya. Menempatkan stop() //hammertimepada setiap contoh berhenti itu tidak lucu.
glasnt

@lasnt - itu komentar yang benar-benar lucu - tetapi itu akan mengganggu iterasi 2, dan semakin membuat jengkel selanjutnya!
amelvin

Membiarkan humor dalam komentar sangat bisa diterima. Mengapa membuat industri yang sudah kering kering DAN tanpa humor? Membiarkan bersumpah atau menghina atau jahat adalah masalah yang sama sekali berbeda. Pengalaman saya benar-benar berbeda dari Anda. Saya sudah sering terkekeh membaca komentar informatif yang menunjukkan selera humor yang jenaka. Itu membuat hari saya lebih baik. Dibutuhkan kecerdasan untuk berselera dalam humor seseorang, tetapi jika itu bisa dilakukan dengan kedewasaan, bawalah.
JBeck

71

Saya penggemar komentar lucu .

Anda harus selalu profesional dalam berkomentar, tetapi humor tidak akan membunuh pembaca.

Terutama jika pembaca adalah anggota tim Anda.

Yang paling tidak saya sukai, adalah pengembang yang menganggap diri mereka terlalu serius. Saya pikir kita harus bersenang-senang di tempat kerja, atau bekerja tidak sepadan.


9
+1 Untuk "Professional but Funny"
deworde

Pemrogramannya sendiri asyik :)
Gopi

2
@Sri Kumar: Sayangnya, tidak selalu. :(
Bobby

1
@ Bobby: ambil keputusan untuk membuatnya jadi menyenangkan! Jika mereka tidak mengizinkan Anda, bawalah kebahagiaan Anda ke perusahaan yang layak mendapatkannya.

3
+1 karena tidak menganggap diri Anda terlalu serius.
JeffO

8

Jika ada artinya, tidak apa-apa untuk menjadi lucu. Menjelaskan sesuatu dalam komentar dengan cara yang lucu tidak masalah. Namun, jika itu hanya sesuatu yang lucu dan tidak mengandung nilai aktual sebagai komentar, itu hanya mengganggu. Selalu ingat bahwa alasan untuk komentar adalah untuk membuat perawatan lebih efisien. Humor tidak harus bertentangan dengan itu, tetapi bisa jika tidak dilakukan dengan tepat.


Ada komentar dalam kode penanganan kesalahan program kritis: "Hidup adalah _ dan kemudian Anda mati." di akhir penjelasan. Ini lucu dan masuk akal.
Michael K

1
@Michael - Itu contoh sempurna dari apa yang saya pikir sia-sia. Itu tidak lucu (menjadi pengulangan lain dari pernyataan yang sangat tua dan lelah) dan tidak menambah nilai.
Brian Knoblauch

8

Kode dimaksudkan untuk membaca ... berkali-kali.

Berapa banyak lelucon yang Anda tahu lucu setelah menceritakan yang keseratus?


@ Thorbjørn Ravn Andersen: bagaimana dengan kartun Dilbert yang Anda cetak dan tempel di dinding bilik Anda? ;)

@Pierre, jika Anda menemukan Dilbert tunggal yang cocok untuk memasukkan komentar kode sumber, beri tahu saya.

@ Thorbjørn Ravn Andersen: bukan Dilbert, tapi yang ini layak digunakan: i.imgur.com/tu7Fd.jpg

@Pierre, sebenarnya saya menganggap kata-kata dalam poster itu melebihi batas dan tidak lucu, tapi itu masalah lain. Berapa banyak lagi yang kamu punya?

@ Thorbjørn Ravn Andersen: hanya itu satu-satunya

7

Komentar lucu itu bagus.

  • Ini memberikan getaran positif ke kode Anda yang tampaknya membosankan.
  • Jika Anda mendapatkan waktu Anda dengan benar. Itu menjelaskan jauh lebih baik daripada komentar membosankan biasa. Yang saya maksud dengan 'timing' di sini adalah relevansi dengan kode di bawah komentar.
  • Kode Anda akan diingat oleh banyak orang, karena emosi diberikan tempat yang lebih baik dalam ingatan (manusia). Ini adalah trik hebat jika Anda ingin lebih banyak orang bekerja dengan Anda pada proyek open-source.
  • Umumnya membantu dalam ulasan. Itu membuat kode Anda jauh lebih tertahankan. Tentu saja Anda harus terlebih dahulu berkonsentrasi pada penulisan kode yang baik. Saya merasa ketika seseorang percaya diri dengan kode yang mereka tulis, komentar lucu hanyalah efek samping.

Hanya saja, jangan lucu seperti orang ini ;)


6

Inilah yang saya tulis jam dua pagi ("DQ" adalah inisial perusahaan saya):

// Twas the night before go-live and all through DQ
// the devs were all crying and yes, this means you.
// Keys had been saved with both hyphens and 'scores
// which left this programmer with finger pad sores.
// The solution I crafted, you'll likely find lacking:
// to OR them together with judicuous hacking.

$hyphenated = str_replace('_','-',$data_type_key);
$underscored = str_replace('-','_',$data_type_key);
// (and then see line 46)

3
Ya, hal-hal seperti itu kemungkinan besar terjadi pada jam 2 pagi, tapi saya tidak merasa ini lelucon yang bagus - seseorang setelah Anda harus membaca 6 baris teks jika dia ingin melihat komentar untuk 2 baris sumber. Rasio yang sama seperti harus membaca 600 baris esai yang menjelaskan 200 baris kode
seseorang

5
Oh, efisiensi ada di luar jendela. Proyek ini sudah seperti gugusan-Anda-tahu-apa, sedikit kesembronoan pergi jauh ke arah semangat 2 pagi. Jika Anda perhatikan, kode yang saya tulis di sini adalah untuk mengatasi kecerobohan orang lain, yang kira-kira seperti dua minggu terakhir mars kematian. Saya tidak memaafkan hal semacam ini sebagai praktik biasa, tetapi saya akui saya cukup senang dengan yang ini.
Dan Ray

Dalam situasi itu saya akan sangat senang juga
seseorang

Jangan mencantumkan nomor baris, gunakan "cari <apa pun>" sebagai gantinya di mana <apa pun> itu sendiri adalah komentar.
Vinko Vrsalovic

3

Jika Anda meninjau kode sumber Anda di depan pelanggan, apakah Anda akan malu?

Tampaknya tidak ada jawaban saat ini yang memperhitungkannya. Beberapa pelanggan tidak memiliki selera humor dan akan menganggap lelucon itu sebagai indikator bahwa Anda tidak menganggap serius pekerjaan Anda. Mereka akan menyimpulkan bahwa Anda ceroboh dengan pekerjaan Anda.

Komentar kode lucu terkadang tidak profesional dan tidak pantas.


3

Di luar apa yang sudah dikatakan, jika Anda bekerja di tim internasional, beberapa rekan di luar negeri Anda mungkin tidak mendapatkan lelucon, karena beberapa referensi budaya lokal atau permainan kata-kata yang tidak dipahami oleh seseorang yang bahasa Inggrisnya bukan bahasa asli . Hal yang sama berlaku untuk proyek sumber terbuka.


2

Jika efisien dan tidak membuang waktu pembaca (baik membaca / memahami) maka saya tidak melihat masalah dengan sedikit humor.


2

Sama seperti lelucon di dunia nyata, jika Anda membuatnya sepanjang waktu itu tidak lucu, tidak produktif, dan tidak profesional. Tapi ada waktu dan tempat untuk semua lelucon, dan ada waktu dan tempat dalam kode. Sama seperti di dunia nyata, ia tahu di mana, kapan, dan bagaimana membuat lelucon.


1

Tergantung, untuk tugas di perguruan tinggi, saya hampir selalu melakukan komentar lucu, karena saya tahu itu tidak akan pernah digunakan dan hanya tugas pekerjaan rumah.

Untuk proyek-proyek yang lebih serius, saya masih menggunakannya di sana-sini, tetapi tidak lazim, sehingga menyebalkan atau sulit dipahami, menentang tujuan komentar.

Saya ingat melakukan sedikit pemrograman web, di mana saya harus menghindari ketidakcocokan browser dan gangguan aneh. Terkadang diakhiri dengan komentar penuh kemarahan dan kebencian pada.js file.

Aturan dasar saya adalah: Jika agak jelas apa yang dilakukan bagian kode, KOMENTAR LUCU MENGHIDUPKAN!

Jika kodenya begitu kabur dan membingungkan (seperti " kelas inline "), saya lebih baik menggunakan komentar saya akan mengerti diri sendiri dalam beberapa hari ...

Dengan menggunakan situs kami, Anda mengakui telah membaca dan memahami Kebijakan Cookie dan Kebijakan Privasi kami.
Licensed under cc by-sa 3.0 with attribution required.