Somehow, getting that quick fix makes you feel safe…

Great article, loved it.

Igor
IgorHelpsYouSucceed´s last blog ..Webmaster Tools Onslaught: Bing vs Google vs Yahoo

So many of them make huge assumptions about the knowledge of their readers. Since I’m a self taught programmer, and therefore don’t have the basic knowledge that most university-taught programmers have, it’s endlessly frustrating to have to stop every minute and go look up what this acronym, or that programming term means. Even if you don’t want to completely dumb down your tutorial for the least knowledgeable of your audience (especially if you expect to attract people who are already somewhat trained in the subject), I still think you should show the tutorial to someone completely outside of the field and then include links that explain any terms, etc. that aren’t familiar to them.

Then they don’t correct spelling, grammar, don’t check to see if their code compiles correctly… *sigh* And so many don’t have a good grasp of the language they’re writing in… of course I understand that many, many programmers (or anyone else who would write any sort of tutorial) don’t speak English as their first language, but I think if you’re going to write any sort of tutorial in a language that’s not your first language, you need to have it looked over by someone who does speak the language well before you publish it. (I know I certainly would if I ever wrote a tutorial in Japanese, for example!)

Okay, rant over. But seriously, I may be passing this post around. I can think of quite a few people (some of whom I know personally) who need to take this advice to heart.
Allison Day´s last blog ..Red Dragon Roll