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