[Robert Abitol] There has been a lot of talk on this wiki about writing tutorials for beginners. 

I am sure these could help certain people. 

But not everyone. I for one am the type of person who can learn well through examples. I find reading the law itself very boring but on the contrary I love to read legal cases. We always find surprising stuff, psychology, interpretations, logic, etc. And even humour at times! 

I am not the only one. A lot of people are like me. There was a saying about learning through examples which I forgot: It said something like when I am told I understand; when I am given an example I understand better. 

The same thing goes for programming.  

With this in mind, I believe the best way to show by examples would be to write comments for each line of code for certain programs. Put yourself in the place of an '''absolute beginner''' who wants to learn Tcl and write comments accordingly. 

These comments could be the '''best tutorial'''!

It's quite a challenge but it can be done. 

For example, [Richard Suchenwirth] has written an excellent search and replace function. See [Simple search and replace]. If anyone would be interested in commenting every line of his code, a lot of beginners could learn a lot of stuff out of it very very quickly. And surely there is no better teacher than RS!

[George Peter Staplin] also writes excellent code; it is very concise, very organized. 

So does [Mike Griffiths].

I am sure others write excellent stuff too. 

I am sure we could learn a lot of stuff from their code if only it was commented in simple terms with the absolute beginner in mind. 

------
[Category Community]