Hacker News new | past | comments | ask | show | jobs | submit login

I found such a thing in a textbook belonging to a friend's mother who went to some kind of household school in the 70s or so. It was a revelation.

When I later wrote some teaching material, I realized that there are two bad kinds of educational texts: Cookbooks and math textbooks. One is a simplistic series of steps without explanation, the other is a facts dump with no motivation, context or intuition.

Getting back to git, its documentation manages to combine the disadvantages of both styles: it is a disjointed cookbook where steps are explained in confusing technical terms that only make sense if you already know the theory, which isn't coherently explained.

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact