{"id":235,"date":"2011-09-01T23:30:15","date_gmt":"2011-09-02T04:30:15","guid":{"rendered":"http:\/\/laurinkeithdavis.com\/wordpress\/?p=235"},"modified":"2011-09-01T23:30:15","modified_gmt":"2011-09-02T04:30:15","slug":"clean-code-a-well-deserved-plug","status":"publish","type":"post","link":"https:\/\/laurinkeithdavis.com\/wordpress\/clean-code-a-well-deserved-plug\/","title":{"rendered":"Clean Code (a well-deserved plug)"},"content":{"rendered":"<p style=\"text-align: justify;\"><a href=\"http:\/\/ecx.images-amazon.com\/images\/I\/41znMZniZ1L._BO2,204,203,200_PIsitb-sticker-arrow-click,TopRight,35,-76_AA300_SH20_OU01_.jpg\"><img loading=\"lazy\" decoding=\"async\" class=\"alignleft\" title=\"Clean Code Book Cover\" src=\"http:\/\/ecx.images-amazon.com\/images\/I\/41znMZniZ1L._BO2,204,203,200_PIsitb-sticker-arrow-click,TopRight,35,-76_AA300_SH20_OU01_.jpg\" alt=\"Book cover for Clean Code by Uncle Bob\" width=\"300\" height=\"300\" \/><\/a>I was sitting in a the <a href=\"http:\/\/lonestarphp.com\/\" target=\"_blank\">Lone Star PHP development conference<\/a> 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&#8230;.well, made me downright uncomfortable. I can&#8217;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 <span style=\"text-decoration: underline;\">well written code<\/span> should have<\/p>\n<p style=\"text-align: justify;\"><strong style=\"font-size: 4em;\">no comments<\/strong>.<\/p>\n<p style=\"text-align: justify;\">Wait a minute&#8230;what??? Yes, that is what he said&#8230;.that does not compute. I have lived under the belief that code should be well\u00a0commented&#8230;.not that I did comment my code well (or that many coders ever do), but I always believed that I <em>should.<\/em><\/p>\n<p style=\"text-align: justify;\">Yet, this guy is not proposing the <em>idea<\/em>\u00a0that that belief is incorrrect&#8230;.he is stating a fact. One that I know to be true when he said it &#8211; 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.)<\/p>\n<p style=\"text-align: justify;\"><a href=\"http:\/\/www.amazon.com\/Clean-Code-Handbook-Software-Craftsmanship\/dp\/0132350882#\" target=\"_blank\">Clean Code: A Handbook of Agile Software Craftsmanship<\/a> by Uncle Bob (aka,<a href=\"http:\/\/www.amazon.com\/Robert-C.-Martin\/e\/B000APG87E\/ref=ntt_athr_dp_pel_1\" target=\"_blank\"> Robert C. Martin<\/a>)<\/p>\n<p style=\"text-align: justify;\">Well,\u00a0I don&#8217;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&#8217;ve read about 5 books and 3 of those are spiritual books, the other 2 were fiction. I DON&#8217;T read books.<\/p>\n<p style=\"text-align: justify;\">\n<p style=\"text-align: justify;\">Still, this presenter&#8217;s simple statement of fact that he seemed to have acquired\u00a0by reading this book would not allow the fact that\u00a0I don&#8217;t read books to deter me. I had to know if this truth could become more than a belief. It&#8217;s one thing to believe something &#8211; belief rarely changes anything substantial. It has to be known in\u00a0a way that makes a difference.\u00a0So,\u00a0that propelled me towards the path of reading\u00a0this book &#8211; well, that and the fact that the book was\u00a0not\u00a0very long and\u00a0was available\u00a0via Kindle (I really\u00a0wasn&#8217;t about to read a book\u00a0that was in paper format.)<\/p>\n<p style=\"text-align: justify;\">Sometimes people misquote the carpenter and say &#8220;the truth will set you free.&#8221; He said &#8220;you will KNOW the truth, and the truth will set you free.&#8221;<\/p>\n<p style=\"text-align: justify;\"><strong>IT DID.<\/strong><\/p>\n<p style=\"text-align: justify;\">(to be continued&#8230;..)<\/p>\n<p style=\"text-align: justify;\">\n<p style=\"text-align: justify;\">\n","protected":false},"excerpt":{"rendered":"<p>I 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 &#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[15,16],"tags":[],"class_list":["post-235","post","type-post","status-publish","format-standard","hentry","category-development","category-php"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.3 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Clean Code (a well-deserved plug) - Laurin Keith Davis<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/laurinkeithdavis.com\/wordpress\/clean-code-a-well-deserved-plug\/\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"laurin1\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/clean-code-a-well-deserved-plug\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/clean-code-a-well-deserved-plug\\\/\"},\"author\":{\"name\":\"laurin1\",\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/#\\\/schema\\\/person\\\/1861bcbaef0e308b3d8425e1c31d5a2b\"},\"headline\":\"Clean Code (a well-deserved plug)\",\"datePublished\":\"2011-09-02T04:30:15+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/clean-code-a-well-deserved-plug\\\/\"},\"wordCount\":444,\"commentCount\":2,\"publisher\":{\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/#\\\/schema\\\/person\\\/fbc4e40a1986326ceb08f5f29f53ff79\"},\"image\":{\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/clean-code-a-well-deserved-plug\\\/#primaryimage\"},\"thumbnailUrl\":\"http:\\\/\\\/ecx.images-amazon.com\\\/images\\\/I\\\/41znMZniZ1L._BO2,204,203,200_PIsitb-sticker-arrow-click,TopRight,35,-76_AA300_SH20_OU01_.jpg\",\"articleSection\":[\"Development\",\"PHP\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/clean-code-a-well-deserved-plug\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/clean-code-a-well-deserved-plug\\\/\",\"url\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/clean-code-a-well-deserved-plug\\\/\",\"name\":\"Clean Code (a well-deserved plug) - Laurin Keith Davis\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/clean-code-a-well-deserved-plug\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/clean-code-a-well-deserved-plug\\\/#primaryimage\"},\"thumbnailUrl\":\"http:\\\/\\\/ecx.images-amazon.com\\\/images\\\/I\\\/41znMZniZ1L._BO2,204,203,200_PIsitb-sticker-arrow-click,TopRight,35,-76_AA300_SH20_OU01_.jpg\",\"datePublished\":\"2011-09-02T04:30:15+00:00\",\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/clean-code-a-well-deserved-plug\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/clean-code-a-well-deserved-plug\\\/#primaryimage\",\"url\":\"http:\\\/\\\/ecx.images-amazon.com\\\/images\\\/I\\\/41znMZniZ1L._BO2,204,203,200_PIsitb-sticker-arrow-click,TopRight,35,-76_AA300_SH20_OU01_.jpg\",\"contentUrl\":\"http:\\\/\\\/ecx.images-amazon.com\\\/images\\\/I\\\/41znMZniZ1L._BO2,204,203,200_PIsitb-sticker-arrow-click,TopRight,35,-76_AA300_SH20_OU01_.jpg\"},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/#website\",\"url\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/\",\"name\":\"Laurin Keith Davis\",\"description\":\"What we have here, is a failure to communicate...\",\"publisher\":{\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/#\\\/schema\\\/person\\\/fbc4e40a1986326ceb08f5f29f53ff79\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":[\"Person\",\"Organization\"],\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/#\\\/schema\\\/person\\\/fbc4e40a1986326ceb08f5f29f53ff79\",\"name\":\"Keith\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/wp-content\\\/uploads\\\/2012\\\/05\\\/2012-04-04-001.jpg\",\"url\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/wp-content\\\/uploads\\\/2012\\\/05\\\/2012-04-04-001.jpg\",\"contentUrl\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/wp-content\\\/uploads\\\/2012\\\/05\\\/2012-04-04-001.jpg\",\"width\":640,\"height\":640,\"caption\":\"Keith\"},\"logo\":{\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/wp-content\\\/uploads\\\/2012\\\/05\\\/2012-04-04-001.jpg\"},\"sameAs\":[\"http:\\\/\\\/www.facebook.com\\\/laurin1\",\"https:\\\/\\\/www.facebook.com\\\/laurin1\",\"https:\\\/\\\/www.instagram.com\\\/laurinkeithdavis\",\"https:\\\/\\\/www.linkedin.com\\\/in\\\/laurin1\",\"https:\\\/\\\/x.com\\\/https:\\\/\\\/twitter.com\\\/laurindavis\"]},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/#\\\/schema\\\/person\\\/1861bcbaef0e308b3d8425e1c31d5a2b\",\"name\":\"laurin1\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/f22d2ca8275d0ed003a18f070dd397b82ba1ad35ed38742c6410652a9a521c69?s=96&d=mm&r=pg\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/f22d2ca8275d0ed003a18f070dd397b82ba1ad35ed38742c6410652a9a521c69?s=96&d=mm&r=pg\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/f22d2ca8275d0ed003a18f070dd397b82ba1ad35ed38742c6410652a9a521c69?s=96&d=mm&r=pg\",\"caption\":\"laurin1\"},\"url\":\"https:\\\/\\\/laurinkeithdavis.com\\\/wordpress\\\/author\\\/laurin1\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Clean Code (a well-deserved plug) - Laurin Keith Davis","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/laurinkeithdavis.com\/wordpress\/clean-code-a-well-deserved-plug\/","twitter_misc":{"Written by":"laurin1","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/laurinkeithdavis.com\/wordpress\/clean-code-a-well-deserved-plug\/#article","isPartOf":{"@id":"https:\/\/laurinkeithdavis.com\/wordpress\/clean-code-a-well-deserved-plug\/"},"author":{"name":"laurin1","@id":"https:\/\/laurinkeithdavis.com\/wordpress\/#\/schema\/person\/1861bcbaef0e308b3d8425e1c31d5a2b"},"headline":"Clean Code (a well-deserved plug)","datePublished":"2011-09-02T04:30:15+00:00","mainEntityOfPage":{"@id":"https:\/\/laurinkeithdavis.com\/wordpress\/clean-code-a-well-deserved-plug\/"},"wordCount":444,"commentCount":2,"publisher":{"@id":"https:\/\/laurinkeithdavis.com\/wordpress\/#\/schema\/person\/fbc4e40a1986326ceb08f5f29f53ff79"},"image":{"@id":"https:\/\/laurinkeithdavis.com\/wordpress\/clean-code-a-well-deserved-plug\/#primaryimage"},"thumbnailUrl":"http:\/\/ecx.images-amazon.com\/images\/I\/41znMZniZ1L._BO2,204,203,200_PIsitb-sticker-arrow-click,TopRight,35,-76_AA300_SH20_OU01_.jpg","articleSection":["Development","PHP"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/laurinkeithdavis.com\/wordpress\/clean-code-a-well-deserved-plug\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/laurinkeithdavis.com\/wordpress\/clean-code-a-well-deserved-plug\/","url":"https:\/\/laurinkeithdavis.com\/wordpress\/clean-code-a-well-deserved-plug\/","name":"Clean Code (a well-deserved plug) - Laurin Keith Davis","isPartOf":{"@id":"https:\/\/laurinkeithdavis.com\/wordpress\/#website"},"primaryImageOfPage":{"@id":"https:\/\/laurinkeithdavis.com\/wordpress\/clean-code-a-well-deserved-plug\/#primaryimage"},"image":{"@id":"https:\/\/laurinkeithdavis.com\/wordpress\/clean-code-a-well-deserved-plug\/#primaryimage"},"thumbnailUrl":"http:\/\/ecx.images-amazon.com\/images\/I\/41znMZniZ1L._BO2,204,203,200_PIsitb-sticker-arrow-click,TopRight,35,-76_AA300_SH20_OU01_.jpg","datePublished":"2011-09-02T04:30:15+00:00","inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/laurinkeithdavis.com\/wordpress\/clean-code-a-well-deserved-plug\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/laurinkeithdavis.com\/wordpress\/clean-code-a-well-deserved-plug\/#primaryimage","url":"http:\/\/ecx.images-amazon.com\/images\/I\/41znMZniZ1L._BO2,204,203,200_PIsitb-sticker-arrow-click,TopRight,35,-76_AA300_SH20_OU01_.jpg","contentUrl":"http:\/\/ecx.images-amazon.com\/images\/I\/41znMZniZ1L._BO2,204,203,200_PIsitb-sticker-arrow-click,TopRight,35,-76_AA300_SH20_OU01_.jpg"},{"@type":"WebSite","@id":"https:\/\/laurinkeithdavis.com\/wordpress\/#website","url":"https:\/\/laurinkeithdavis.com\/wordpress\/","name":"Laurin Keith Davis","description":"What we have here, is a failure to communicate...","publisher":{"@id":"https:\/\/laurinkeithdavis.com\/wordpress\/#\/schema\/person\/fbc4e40a1986326ceb08f5f29f53ff79"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/laurinkeithdavis.com\/wordpress\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":["Person","Organization"],"@id":"https:\/\/laurinkeithdavis.com\/wordpress\/#\/schema\/person\/fbc4e40a1986326ceb08f5f29f53ff79","name":"Keith","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/laurinkeithdavis.com\/wordpress\/wp-content\/uploads\/2012\/05\/2012-04-04-001.jpg","url":"https:\/\/laurinkeithdavis.com\/wordpress\/wp-content\/uploads\/2012\/05\/2012-04-04-001.jpg","contentUrl":"https:\/\/laurinkeithdavis.com\/wordpress\/wp-content\/uploads\/2012\/05\/2012-04-04-001.jpg","width":640,"height":640,"caption":"Keith"},"logo":{"@id":"https:\/\/laurinkeithdavis.com\/wordpress\/wp-content\/uploads\/2012\/05\/2012-04-04-001.jpg"},"sameAs":["http:\/\/www.facebook.com\/laurin1","https:\/\/www.facebook.com\/laurin1","https:\/\/www.instagram.com\/laurinkeithdavis","https:\/\/www.linkedin.com\/in\/laurin1","https:\/\/x.com\/https:\/\/twitter.com\/laurindavis"]},{"@type":"Person","@id":"https:\/\/laurinkeithdavis.com\/wordpress\/#\/schema\/person\/1861bcbaef0e308b3d8425e1c31d5a2b","name":"laurin1","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/f22d2ca8275d0ed003a18f070dd397b82ba1ad35ed38742c6410652a9a521c69?s=96&d=mm&r=pg","url":"https:\/\/secure.gravatar.com\/avatar\/f22d2ca8275d0ed003a18f070dd397b82ba1ad35ed38742c6410652a9a521c69?s=96&d=mm&r=pg","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/f22d2ca8275d0ed003a18f070dd397b82ba1ad35ed38742c6410652a9a521c69?s=96&d=mm&r=pg","caption":"laurin1"},"url":"https:\/\/laurinkeithdavis.com\/wordpress\/author\/laurin1\/"}]}},"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/p16SmA-3N","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/laurinkeithdavis.com\/wordpress\/wp-json\/wp\/v2\/posts\/235","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/laurinkeithdavis.com\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/laurinkeithdavis.com\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/laurinkeithdavis.com\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/laurinkeithdavis.com\/wordpress\/wp-json\/wp\/v2\/comments?post=235"}],"version-history":[{"count":6,"href":"https:\/\/laurinkeithdavis.com\/wordpress\/wp-json\/wp\/v2\/posts\/235\/revisions"}],"predecessor-version":[{"id":242,"href":"https:\/\/laurinkeithdavis.com\/wordpress\/wp-json\/wp\/v2\/posts\/235\/revisions\/242"}],"wp:attachment":[{"href":"https:\/\/laurinkeithdavis.com\/wordpress\/wp-json\/wp\/v2\/media?parent=235"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/laurinkeithdavis.com\/wordpress\/wp-json\/wp\/v2\/categories?post=235"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/laurinkeithdavis.com\/wordpress\/wp-json\/wp\/v2\/tags?post=235"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}