xah's thoughts extempore, episode 201311171455, on technical writing.

the most idiotic tutorial idiom in OOP is using fruits, banana, apple, analogy, or using Shapes, circle, square.

Why? because, when you read those english words, your head started to nod, but you actually understood nothing. You think you understand, but when pressed in details, you wouldn't be able to answer.

So, instead of using fruits, apple, thingy, use abstract symbols, x, y, z, math, that is.

That is the beauty of math, and that's also why math is like that.

because, in order to truly understand, you want to get rid of irrelevancies. Fruits, Apple, some semantic connotation is irrelevant. (analogy sometimes helps, but often just confound.)

try this. pick a tutorial of oop lang you don't know a thing.
find the chapter on class/object.
find/replace in code examples of words like fruit/shapes to x, y, z.

try to read the code.

here's my claim.

Of those who read fruit/shapes, they will understand less about the lang than those who tried to read the xyz version. And this can be verified by a test. e.g. ask them to create a new class or object, decide what's the inheritance, etc
#java   #javascript   #writing  
Shared publiclyView activity