Hacker News Reader

Comment by Locke1689 | Hacker News Reader

He's not simplifying things by putting the filename at the top of the file: he's just wrong. This is stuff which is clearly learned because people who don't know how to program correctly pass on little pieces of code like secret incantations without really thinking about them.

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.

View on HN

Sorry, but this comes off as typical nerd-rage, nitpicking about things that don't matter.

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.

He's not upset about the filename-comment per se, he's worried that it's an early warning--it indicates that Khan isn't very experienced with software development (which, in my opinion, is a valid conclusion), and that that'll cause more serious problems in the future.

Like what? (Seriously; more people getting interested in programming, candidates after Khan's video's somehow "slipping through" the interview process for a Jr position? Or, (where I can see your point), setting up bad practices?))

Yes, its obvious that he hasn't written a lot of production code. Again, so what?. That's not in any way an early warning that he isn't capable of teaching basic programming skills to others.

exactly. if the viewers of these videos intend to become serious software developers then they can just correct whatever wrong shit they learn. if they don't care about best practices then it is still better that they know how to do the basics to automate mundane tasks then not know any at all.

Remember when people started slamming him for oversimplifying history, or getting other minor facts wrong on non-programming subjects? Everyone on HN just said "it's free, it's interesting, and who cares as long as students get the basic idea?"

Now that he's making minor mistakes on programming, HNers are upset he's not a software engineering expert.

I'm willing to cut the guy a break. ;) However now that donations (I assume) are coming in, its probably about time to start consulting with experts before starting a class.

Willing to cut the guy a break, huh? How big of you.

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?

Woosh.

I'm not being hypocritical: I think that he should start consulting experts for all his classes. I'd much rather have a site that crowdsources experts to teach topics than have one guy with a shallow depth of field on a lot of topics do it.

I don't know how much code Sal has written, but, depending on the project/coding standards, I've seen a lot of code with filename comments at the top. It's not really an indicator of experience or skill.

Yeah, that's an odd gripe. Check out code igniter for example. One ofthe popular php frameworks...filenames in comments.

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'm saying that Sal violated basic programming practice in one of the simplest 10 line programs that can be written. This is a canary.

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.

More proof that no good deed goes unpunished.

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.

First, your argument is a logical fallacy. There's no reason why I need to give a better solution in order to point out that an existing one is not good enough.

Second, I feel no need to replicate LPTHW.

When I referred to simplification, it was more in reference to the comment about not using PyDoc than to the filename issue. Regarding the filename issue, I think you are blowing it completely out of proportion. I don't personally believe in it, but it's definitely a style thing, and it's definitely not something that only people who don't know how to program do.

Reply on news.ycombinator.com