I would hardly think it appropriate to tell somebody how to do something they do on their free time with no compensation whatsoever. |
As someone who regularly contributes to tutorial writings, online forum postings, code snippits, etc with no monetary compensation, I have to strongly disagree.
Own up to your work. Saying "well I did it for free" isn't a free pass to do a sloppy job.
It may seem like a noble gesture to do community service... but if all you're doing is slowing down/hindering the process, you just frustrate everyone else who's trying to do the same community service (not to mention making it harder on the people receiving the service).
Going as far as to insult someone because you don't like the way their tutorial is written is too far, though, I agree.
I'd much rather have someone tell me my work is wrong and/or could be improved than have them slander me behind my back.
It's not like this person is maliciously spreading bad practice, he just doesn't know any better. The only way he can know better is if someone tells him.
@ chrisname: if this really bothers you that much, write to the tutorial author and recommend changes. But keep a civil tone when you do so. You catch more flies with honey, etc.
But I wouldn't hold out hope for a tutorial update. He may have lost interest and/or may not be available to contact.
As it is, free tutorials in general are tough to find. |
I never said he shouldn't write tutorials. I said he should do a better job of writing them. I suppose this is a "take what you can get" situation, but that's kind of the problem. When "what you can get" is bad examples, that's a problem that should be addressed.
Dangerous in what way? I fail to see any real danger in it at all. |
Misinformation in an authoritative tone is harmful because it gives someone the impression they're doing things correctly, when in fact they're doing things all wrong.
What's more, when a coder who has more insight and/or better code comes along and tries to correct the reader or show the reader better practice, he's met with skepticism because the reader will fall back to "well the tutorial said to do it THIS way, I don't see why I should change".
The coder could give a long list of reasons to the reader why he should change his practies, but because he doesn't seem as "official" as a tutorial, it might fall on deaf ears.
So a bad tutorial not only can steer people in all the wrong direction, but it can also make it harder for them to find the right direction,
AND can frustrate other people who are looking to help.