Well put. Except: > And, of course, the infamous "programming by poking" metaphor from Sussman: "You grab this piece of library and you poke at it. You write

Well put. Except: > And, of course, the infamous "programming by poking" metaphor from Sussman: "You grab this piece of library and you poke at it. You write programs that poke it and see what it does. And you say, 'Can I tweak it to do the thing I want?'" In other words, programming by hermeneutics. I'm afraid that this is sometimes the excuse for not documenting software -- sort of a, "Hey, here it is, just poke at it, you'll figure it out!" kind of attitude. Eat your veggies, rotate your tires, document your code.