undefined | Better HN

0 pointsstouset9d ago0 comments

That isn’t even about black magic wizardry. That tutorial covers adding files, committing, switching branches, and merging: in other words, the absolute basics. It was, and maybe still is, one of the best beginner resources on how to make sense of the git CLI for people who are confused.

And it required at least twenty diagrams.

What do I want from you? Maybe a little less high-and-mighty a tone when dismissing a tool for being so complicated someone decided to use diagrams to explain it, when the very thing being replaced is so complicated that one of the best beginner resources needed to use diagrams to explain it.

0 comments

applfanboysbgon8d ago

You certainly do not need 20 diagrams to learn the basics of Git. If I had to consume the article you linked to start using Git, I would not have been convinced to. The article itself states that it assumes readers already know how to use it, so if that's what beginners are being pointed to, I think that's a crime against pedagogy.

stousetOP8d ago

You certainly don’t need 20 diagrams to understand why you’d want to use jj. This author happened to think it would be useful. Apparently pictures of data structures are crimes.

Meanwhile, that article is inarguably the thing that made git “click” for an enormous number of people regardless of your disapproval of how some people prefer to learn.

Maybe be less judgmental.

1 more reply

j / k navigate · click thread line to collapse