Git’s arcane command syntax is a thing of legend and after years of using it I still find myself being mystified by so many things once I need to delve beyond the usual.
Sorry if it’s already been mentioned but this fake git man page generator gives me a big stupid grin every time I use it:
https://git-man-page-generator.lokaltog.net/ (I’m sure it’s been linked on HN before)
The documentation it generates just so plausible with the kind of verbs and nouns it uses, and how the help text is always descriptive, but never really helpful.
GIT is a technical marvel, and due to its immense usefulness many people have mastered it and have become more productive because of it.
But that doesn’t mean it’s not confusing, both over- and under-documented and unpredictable.
To me it’s a bit like seeing someone work with highly specialized systems (think: CAD or a particle collider): who am I to say it “doesn’t work”, these people are designing cars and discovering bosons. But still I think: if someone could design these things again from scratch, they could likely be even better.
Sorry if it’s already been mentioned but this fake git man page generator gives me a big stupid grin every time I use it: https://git-man-page-generator.lokaltog.net/ (I’m sure it’s been linked on HN before)
The documentation it generates just so plausible with the kind of verbs and nouns it uses, and how the help text is always descriptive, but never really helpful.