Comments on: Literate Programming: Elegance and good taste matter! http://tinobox.com/wordpress/coding/literate-programming-elegance-and-good-taste-matter/ Odds and ends of internet entrepreneurship—A Technical Diary Mon, 30 Jan 2012 15:07:37 +0000 hourly 1 http://wordpress.org/?v=3.3.1 By: 3 Fast Techniques for Thesis Theme custom_functions.php | Website In A Weekend http://tinobox.com/wordpress/coding/literate-programming-elegance-and-good-taste-matter/comment-page-1/#comment-4046 3 Fast Techniques for Thesis Theme custom_functions.php | Website In A Weekend Tue, 16 Nov 2010 07:12:44 +0000 http://tinobox.com/wordpress/?p=57#comment-4046 [...] here is staggering. I don’t need to read code. I can see what it does by looking at the bit literate file name. If the file doesn’t exist, it doesn’t try and load and [...] [...] here is staggering. I don’t need to read code. I can see what it does by looking at the bit literate file name. If the file doesn’t exist, it doesn’t try and load and [...]

]]> By: How To Create Custom Template Pages in Thesis Theme | Website In A Weekend http://tinobox.com/wordpress/coding/literate-programming-elegance-and-good-taste-matter/comment-page-1/#comment-2622 How To Create Custom Template Pages in Thesis Theme | Website In A Weekend Thu, 15 Apr 2010 00:51:57 +0000 http://tinobox.com/wordpress/?p=57#comment-2622 [...] It’s true about literate programming: elegance and good taste matter! [...] [...] It’s true about literate programming: elegance and good taste matter! [...]

]]> By: Jean-Philippe Daigle http://tinobox.com/wordpress/coding/literate-programming-elegance-and-good-taste-matter/comment-page-1/#comment-114 Jean-Philippe Daigle Sat, 01 Mar 2008 05:42:07 +0000 http://tinobox.com/wordpress/?p=57#comment-114 I agree this do - do not - do - do - do pattern is probably poorly thought-out in this particular case, but sometimes it's not so obvious. Say you need to implement a command-line option for an imaginary program, that enables or disables Nagle's algorithm on sockets owned by that program. How would you name it? Would you call it "enable TCP_NODELAY", which disables Nagle (which is enabled by default) (and wouldn't that be confusing?) Would you call it "disable Nagle's algorithm", which takes the negative route, and thus would clash with the other options? I agree this do – do not – do – do – do pattern is probably poorly thought-out in this particular case, but sometimes it’s not so obvious.

Say you need to implement a command-line option for an imaginary program, that enables or disables Nagle’s algorithm on sockets owned by that program. How would you name it?

Would you call it “enable TCP_NODELAY”, which disables Nagle (which is enabled by default) (and wouldn’t that be confusing?)
Would you call it “disable Nagle’s algorithm”, which takes the negative route, and thus would clash with the other options?

]]>