Comments on: Revisiting the Comments Debate: The Self-Documenting Code Contest http://blog.uncommons.org/2008/08/05/revisiting-the-comments-debate-the-self-documenting-code-contest/ Rants and opinion interspersed with awe-inspiring tales of heoric software engineering endeavours. Tue, 06 Jan 2009 23:06:39 +0000 http://wordpress.org/?v=2.7 hourly 1 By: paan http://blog.uncommons.org/2008/08/05/revisiting-the-comments-debate-the-self-documenting-code-contest/comment-page-1/#comment-2208 paan Wed, 06 Aug 2008 15:56:37 +0000 http://blog.uncommons.org/?p=106#comment-2208 even though you got disqualified I'm still rooting for you to win the contest. I'm really am in the "less comment is good" camp.. but I don't really think that no comment at all is good.. anyway.. since they arbitrary chose the word "documenting" rather than say create a program that can take any word and create a 2 word anagram, using the word documenting as an example, it really means that the best way to do the program is your way.. even though you got disqualified I’m still rooting for you to win the contest.
I’m really am in the “less comment is good” camp.. but I don’t really think that no comment at all is good..

anyway.. since they arbitrary chose the word “documenting” rather than say create a program that can take any word and create a 2 word anagram, using the word documenting as an example, it really means that the best way to do the program is your way..

]]> By: Self Documenting Code Contest : Where Sparkes Used to Fly http://blog.uncommons.org/2008/08/05/revisiting-the-comments-debate-the-self-documenting-code-contest/comment-page-1/#comment-2203 Self Documenting Code Contest : Where Sparkes Used to Fly Wed, 06 Aug 2008 09:02:07 +0000 http://blog.uncommons.org/?p=106#comment-2203 [...] Read all about it here via New adventures in software [...] [...] Read all about it here via New adventures in software [...]

]]> By: Daily Nerd News » Blog Archive » Self Documenting Code Contest http://blog.uncommons.org/2008/08/05/revisiting-the-comments-debate-the-self-documenting-code-contest/comment-page-1/#comment-2202 Daily Nerd News » Blog Archive » Self Documenting Code Contest Wed, 06 Aug 2008 09:01:39 +0000 http://blog.uncommons.org/?p=106#comment-2202 [...] all about it here via New adventures in software Top blogs deconstructed, Real life photoshop., top 30 bits of javascript, Hottest jobs in IT or why [...] [...] all about it here via New adventures in software Top blogs deconstructed, Real life photoshop., top 30 bits of javascript, Hottest jobs in IT or why [...]

]]> By: Dan http://blog.uncommons.org/2008/08/05/revisiting-the-comments-debate-the-self-documenting-code-contest/comment-page-1/#comment-2188 Dan Wed, 06 Aug 2008 00:17:30 +0000 http://blog.uncommons.org/?p=106#comment-2188 Sharfah, I'll concede your first point. "get" is better than "generate". I'm not sure I agree with the second though. You don't need to know where I got the words from ;) Sharfah, I’ll concede your first point. “get” is better than “generate”. I’m not sure I agree with the second though. You don’t need to know where I got the words from ;)

]]> By: sharfah http://blog.uncommons.org/2008/08/05/revisiting-the-comments-debate-the-self-documenting-code-contest/comment-page-1/#comment-2187 sharfah Tue, 05 Aug 2008 23:46:11 +0000 http://blog.uncommons.org/?p=106#comment-2187 Well, you're not generating them so you can't call it generateAllTwoWordAnagramsOfTheWordDocumenting! Also, looking at your code, there is nothing in there to tell me where you got those two word anagrams from. A better name would be: getEightPairsOfWordsFromTheWordDocumentingFromTheAir= ["ceding mount", "document gin", "condign mute", "induct gnome", "coming tuned", "gnomic tuned", "cumin tonged", "cum denoting"] You fail! Well, you’re not generating them so you can’t call it generateAllTwoWordAnagramsOfTheWordDocumenting! Also, looking at your code, there is nothing in there to tell me where you got those two word anagrams from.

A better name would be:
getEightPairsOfWordsFromTheWordDocumentingFromTheAir=
["ceding mount", "document gin", "condign mute", "induct gnome",
"coming tuned", "gnomic tuned", "cumin tonged", "cum denoting"]

You fail!

]]>