{"id":6343,"date":"2013-01-09T11:55:56","date_gmt":"2013-01-09T11:55:56","guid":{"rendered":"http:\/\/www.flubu.com\/blog\/?p=6343"},"modified":"2013-01-09T11:55:56","modified_gmt":"2013-01-09T11:55:56","slug":"best-code-comments","status":"publish","type":"post","link":"https:\/\/www.flubu.com\/blog\/2013\/01\/09\/best-code-comments\/","title":{"rendered":"Best code comments"},"content":{"rendered":"<p>Software developers are a whimsy bunch. Sometimes, the long hours and tiredness makes your brain go bye-bye. This is the result:<\/p>\n<pre style=\"font-family: monospace;font-size: 10pt;\">\/**\r\n* For the brave souls who get this far: You are the chosen ones,\r\n* the valiant knights of programming who toil away, without rest,\r\n* fixing our most awful code. To you, true saviors, kings of men,\r\n* I say this: never gonna give you up, never gonna let you down,\r\n* never gonna run around and desert you. Never gonna make you cry,\r\n* never gonna say goodbye. Never gonna tell a lie and hurt you.\r\n*\/\r\n\r\n\/\/ \r\n\/\/ Dear maintainer:\r\n\/\/ \r\n\/\/ Once you are done trying to 'optimize' this routine,\r\n\/\/ and have realized what a terrible mistake that was,\r\n\/\/ please increment the following counter as a warning\r\n\/\/ to the next guy:\r\n\/\/ \r\n\/\/ total_hours_wasted_here = 42\r\n\/\/ \r\n\r\n\/\/When I wrote this, only God and I understood what I was doing\r\n\/\/Now, God only knows\r\n\r\nstop(); \/\/ Hammertime!\r\n\r\n\/\/Dear future me. Please forgive me. \r\n\/\/I can't even begin to express how sorry I am.  \r\n\r\n\/\/private instance variable for storing age\r\npublic static int age;\r\n\r\noptions.BatchSize = 300; \/\/Madness? THIS IS SPARTA!\r\n\r\n\/\/I am not sure why this works but it fixes the problem. \r\n\r\n\/\/This code sucks, you know it and I know it.  \r\n\/\/Move on and call me an idiot later.\r\n\r\n\/\/ I am not responsible of this code.\r\n\/\/ They made me write it, against my will.\r\n\r\n\/\/ drunk, fix later\r\n\r\n#define TRUE FALSE \/\/Happy debugging suckers\r\n<\/pre>\n<p>I&#8217;m probably guilty of a few similar ones myself. Makes me giggle :)<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Software developers are a whimsy bunch. Sometimes, the long hours and tiredness makes your brain go bye-bye. This is the result: \/** * For the brave souls who get this far: You are the chosen ones, * the valiant knights of programming who toil away, without rest, * fixing our most awful code. To you,&#8230;<\/p>\n<p class=\"more-link-wrap\"><a href=\"https:\/\/www.flubu.com\/blog\/2013\/01\/09\/best-code-comments\/\" class=\"more-link\">Read More<span class=\"screen-reader-text\"> &ldquo;Best code comments&rdquo;<\/span> &raquo;<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"ngg_post_thumbnail":0,"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":""},"categories":[1],"tags":[24],"class_list":["post-6343","post","type-post","status-publish","format-standard","hentry","category-uncategorized","tag-computers-are-evil"],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/p3u9vK-1Ej","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.flubu.com\/blog\/wp-json\/wp\/v2\/posts\/6343","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.flubu.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.flubu.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.flubu.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.flubu.com\/blog\/wp-json\/wp\/v2\/comments?post=6343"}],"version-history":[{"count":7,"href":"https:\/\/www.flubu.com\/blog\/wp-json\/wp\/v2\/posts\/6343\/revisions"}],"predecessor-version":[{"id":6350,"href":"https:\/\/www.flubu.com\/blog\/wp-json\/wp\/v2\/posts\/6343\/revisions\/6350"}],"wp:attachment":[{"href":"https:\/\/www.flubu.com\/blog\/wp-json\/wp\/v2\/media?parent=6343"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.flubu.com\/blog\/wp-json\/wp\/v2\/categories?post=6343"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.flubu.com\/blog\/wp-json\/wp\/v2\/tags?post=6343"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}