This video isn't trying to make people into professional developers any more than his videos on algebra are trying to teach research-oriented mathematics.
Now that he's making minor mistakes on programming, HNers are upset he's not a software engineering expert.
Are you willing to actually do any work to improve it, or give a big cash grant so KhanAcademy.org can hire those professional programmers to help out?
I guess I can understand why people criticize Khan but it seems so wrong. Just pretend that khan is for the other 7 billion people!
I didn't think that the video (now dead) was particularly good, but I think that this is a bit of an overreaction. LPTHW doesn't seem to use PyDoc comments either. Would I be upset if he used C# and put a // comment at the top of a method, instead of a /// comment? Probably. Would I regard it as evidence that he wouldn't be able to teach programming? No.
He's not simplifying things by putting the filename at the top of the file: he's just wrong
Maybe this is a Python thing, but there's a semi-official, but fairly popular tool from Microsoft called StyleCop that forces C# code to have a comment with the filename at the top. Bottom line: putting a filename at the top is not regarded universally as a bad practice, even among professional programmers.
Will you be putting up your own website of free programming tutorial videos done the way you think they ought to be done? Will you offer to volunteer your time to Khan Academy.org to produce programming videos the way you think they should be done?
Yeah... that's what I though.
Second, I feel no need to replicate LPTHW.
I'm not saying that adding extraneous comments at the top of your file is the end of the world: I'm saying that Sal violated basic programming practice in one of the simplest 10 line programs that can be written. This is a canary.
What makes good teachers so good is that they know their field so well that they can use all of their gathered knowledge to help clarify and guide people who don't know any better. It doesn't matter how good a teacher you are if you really don't know what you're teaching.