November 14, 2018
  • What we have here, is a failure to communicate…

Clean Code (a well-deserved plug)

Book cover for Clean Code by Uncle BobI was sitting in a the Lone Star PHP development conference a couple of months and was listening to a guy talk about some seemingly relevant topic (to which I would give credit, if I could remember who it was and what he was talking about), but what I was struck by was with the conviction he spoke about a methodology in development of which had characteristics that….well, made me downright uncomfortable. I can’t remember all of the ideas he conveyed that had this effect on me, but the one that got my attention the most was the idea that well written code should have

no comments.

Wait a minute…what??? Yes, that is what he said….that does not compute. I have lived under the belief that code should be well commented….not that I did comment my code well (or that many coders ever do), but I always believed that I should.

Yet, this guy is not proposing the idea that that belief is incorrrect….he is stating a fact. One that I know to be true when he said it – but not knowing how this is possible. Thank God he did not leave me hanging, but went on to describe the source of this fact (or really the source that points to this fact, of which is the method that all real truth is conveyed.)

Clean Code: A Handbook of Agile Software Craftsmanship by Uncle Bob (aka, Robert C. Martin)

Well, I don’t read books. I used to, as a kid, read a lot. I read tons of fantasy and science fiction novels. In the last 10 years, I’ve read about 5 books and 3 of those are spiritual books, the other 2 were fiction. I DON’T read books.

Still, this presenter’s simple statement of fact that he seemed to have acquired by reading this book would not allow the fact that I don’t read books to deter me. I had to know if this truth could become more than a belief. It’s one thing to believe something – belief rarely changes anything substantial. It has to be known in a way that makes a difference. So, that propelled me towards the path of reading this book – well, that and the fact that the book was not very long and was available via Kindle (I really wasn’t about to read a book that was in paper format.)

Sometimes people misquote the carpenter and say “the truth will set you free.” He said “you will KNOW the truth, and the truth will set you free.”


(to be continued…..)

Comments List

dustinmoormanSeptember 3, 2011 9:13 pm /

+1. Awesome book! I am perusing the market for a *good deal* on a paper copy.. I seem to soak those in more easily than ebooks. Not that ebooks are bad. I'm just sayin'

laurin1September 3, 2011 9:33 pm /

PRIDE will pay for a copy, unless you just want your own.