OK, last time I ranted about how most programming tutorials don't really tell you anything. I've pinpointed exactly what they don't tell you. Most tutorial writers tell you the proper syntax of loops, functions, methods, whatever, and for most languages that's fine because the programs are written the same way. But some languages, like Python, don't necessarily rely on functions to define the structure of the code. In C and many languages like it, there is the main() function and you know thats the beginning of the program. In Python, there is no main() function.
While I can figure out to put stuff wherever I can fit it, some people can get confused by this, especially beginner programmers. I mean, really, authors please take into consideration that your readers may not have as much experience as you and they may need an extra sentence or two describing the structure of a program. Or like I said earlier, while you're writing your tutorial, write a little program that demonstrates how to use all the primary features of the language while putting them in context. It makes things alot easier and by doing this, you open the doors to better programmers in the future that may have gotten their start from reading your material. Take a little pride in your work and put some extra effort into your instruction by adding clear context to your example code.
Oh, and btw, please stop using the command line interpreter to show us how to do one line at a time. No one writes a program one line at a time. Its completely useless to show us anything there. Write it with some other code to let us know how at least TWO lines can interact with one another.

Must be logged in to post comments