my attempt for a new endeavour: debugging2day - Linux/C/C++-centric debugging methodologies online E-zine

my attempt for a new endeavour: debugging2day - Linux/C/C++-centric debugging methodologies online E-zine

Shlomi Fish shlomif at shlomifish.org
Tue Jan 8 14:04:50 IST 2013


Hi Guy,

On Sun, 06 Jan 2013 02:41:13 +0200
guy keren <guy.choo.keren at 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 .



More information about the Linux-il mailing list