เมื่อ Comment ใน code ไม่ใช่เรื่องเล่น ๆ !!

comment-00

จากคำถามใน Quora.com เรื่อง What is the best comment in source code that you have ever encountered ? ว่าด้วยเรื่องการ comment ใน source code ที่ดี มันเป็นคำถามที่ดีมาก ๆ รวมทั้งคำตอบต่าง ๆ ก็น่าสนใจ แต่ก็มีบางคำตอบที่ฮา ๆ เยอะเช่นกัน มาดูกันหน่อยสิ

เริ่มด้วย comment ที่เหมือนจะฮา แต่คิดว่าไม่ฮา !!

code เหล่านี้ต้องไม่เคยผ่านการทำ code review แน่ ๆ บริษัทที่จ้าง developer คนนี้ไม่น่าจะพอใจนะ [code] The company pays no bonus - forget about it dude. Don't come! I'm ready to leave! This project contains huge amount of bugs. You won't stay long! Bye! Best luck! [/code] comment-01

ถ้าเจอ code แบบนี้ไม่น่าจะชอบกันนะ !! [code] IF TIMEDIFF >=5 SAY "THE SYSTEM IS FUCKED, PLEASE BEAR WITH US" SLEEP(10) ENDIF [/code] ถ้าเจอแบบนี้จะกล้าแก้ไขไหม ? [code] //When I wrote this, only God and I understood what I was doing //Now, God only knows /* You are not expected to understand this */ // // Dear maintainer: // // Once you are done trying to 'optimize' this routine, // and have realized what a terrible mistake that was, // please increment the following counter as a warning // to the next guy: // // total_hours_wasted_here = 42 // [/code] ถ้าเจอ comment แบบนี้ ก็เอาที่สบายใจกันนะ [code] if (counts < 0xFF567812 ) // Programmer1 - WTF is this magic number bullshit // Programmer2 - I have no fucking clue. I've been trying to figure it out for years. // Programmer1 - We should figure this out and comment it // Programmer3 - Did we ever figure this out? // Programmer2 - No [/code] หรือเจอ code แบบนี้จะทำการ comment หรือปรับปรุงกันดีนะ ? comment-06