News for hackers. Stuff that matters.
Re:Common Git Problems and How to Fix Them by ahartmetz on Sunday July 29, 2018 @10:20AM (#17638251)
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.

There are no comments on this comment yet.