Hi Guy, On Sun, 06 Jan 2013 02:41:13 +0200 guy keren <guy.choo.ke...@gmail.com> wrote:
> > for want of a shorter name ;) > > i started this last year, then got a little lazy - and now that the > world didn't come to an end, decided to give it a second go - and this > time, even tell people about this :0 > > > http://debugging2day.wordpress.com/ > > if anyone has comments, or has ideas or requests for article topics > (assuming they are within my grasp) - feel free to share. I find debugging to be an interesting topic because I spend a lot of time debugging (even when I have a comprehensive test suite which mitigates part of this problem) and have also contributed to some of the various perl's debuggers, recently as part of a (mostly) successfully finished Perl Foundation grant. However... I found your debugging2day blog a little lacking, and I'll try to explain while giving what I hope is constructive criticism: 1. The first thing is that it is too full of long prose. In order to spice up web hypertext, one can use various visual aids: <ul>s and <ol>s , headers, hyperlinks, text in bold, images (but not animations or Adobe Flash applets please though) such as diagrams, screenshots or photos, etc. etc. You have it a little but you should include more of that. 2. I agree with what Joel Spolsky says here - http://www.joelonsoftware.com/articles/BestSoftwareWriting.html - that the best way to make a point in an essay is to tell a story that exemplifies it instead of giving advice in a pie-in-the-sky or preachy way. Maybe I have missed some things there but I don't see a lot of actual stories there to pique my interest. 3. For some reason, I find it hard to concentrate on reading the text in http://debugging2day.wordpress.com/ - maybe the font is too small, or the grey text (at least I think it is grey) has too little contrast with the white background or something, but I think it can be made to be more usable and inviting and so more people will be inclined to read it. ------------ Arguably, I have violated some of these principles in some of my posts (a lot of which I'm not sure if anyone bothered to read, but I still like to write them), but see http://en.wikipedia.org/wiki/Tu_quoque . Regards, Shlomi Fish -- ----------------------------------------------------------------- Shlomi Fish http://www.shlomifish.org/ UNIX Fortune Cookies - http://www.shlomifish.org/humour/fortunes/ I’d do Windows-- , but this may result in an integer underflow. — an Israeli Linuxer. Please reply to list if it's a mailing list post - http://shlom.in/reply . _______________________________________________ Linux-il mailing list Linux-il@cs.huji.ac.il http://mailman.cs.huji.ac.il/mailman/listinfo/linux-il
