Mailing List Archive


[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [tlug] Printers for linux, was: refurbished Thinkpad X60 with Coreboot & Linux



On Monday, December 30, 2013, Stephen J. Turnbull wrote:
Benjamin Tayehanpour writes:

 > Well, isn't that what code comments are for? *ducks*

You'd better duck.  After a couple revisions, code comments are a
device for ensuring that little bit of residual FUD, even though you
*know* what the code does from reading it.  The code is crystal clear
but the comments, oh boy!

In a book I recently read (I think it was "Clean Code", but I can't remember for sure), the author posited that "every comment in code is a failure". He made the exception of comments that are there to explain the why.

Cheers,
Josh


--
Sent from my iPhone. Please excuse the brevity and potential typos.

Home | Main Index | Thread Index

Home Page Mailing List Linux and Japan TLUG Members Links