News for hackers. Stuff that matters.
Re:How to teach Git by ahartmetz on Wednesday January 16, 2019 @09:56AM (#18921313)
And here is something to take the garbage quality of Git manpages with some humor

https://git-man-page-generator.lokaltog.net/

"git-eliminate-head eliminates all downstream heads for a few forward-ported non-counted downstream indices, and you must log a few histories and run git-pioneer-object --pose-file instead. [...]"

Re:How to teach Git by romwell on Wednesday January 16, 2019 @03:54PM (#18925077)
This is a kind of very specific, targeted, niche comedy, excellently executed. I only use Git casually, and I can't tell how much of that text couldn't make sense in an actual doc; it all looked real enough at a glance.

Thank you for sharing, this made my week.

Re:How to teach Git by Groxx on Wednesday January 16, 2019 @05:01PM (#18925890)
Impressively small generator data too, given how realistic it reads: https://github.com/Lokaltog/baba-grammar-git-man-page-genera...

but maybe that's due to the low bar that it's being compared to.

Re:How to teach Git by virtualwhys on Wednesday January 16, 2019 @09:11PM (#18927696)
Please note[1] that:

> To rev-parse an automatic FLOUNDER_LOG or diff the working subtrees, use the command git-link-submodule --retrieve-wrestle-change.

I often overlook this detail when trying to hulk smash some broken change I've made upstream (what the manual entry correctly refers to as RIP_OTHER_TIP).

[1] https://git-man-page-generator.lokaltog.net/#81394c8bf3806f9...

Re:How to teach Git by MisterOctober on Wednesday January 16, 2019 @08:21PM (#18927464)
Brilliant, absolutely had me rolling. Most cleverly-executed satire I've seen in a long while.

"To parse a staged SKIRT_SUBTREE and blame the working histories, use the command git-purchase-pack --snuggle-muster-branch, as after reapplying subtrees..."

Re:How to teach Git by pferde on Wednesday January 16, 2019 @10:00AM (#18921350)
Thank you for this, it made my day. :)
Re:How to teach Git by euske on Wednesday January 16, 2019 @08:11PM (#18927416)
Am I only one who's getting an error on Firefox?

    Content Security Policy: The page’s settings blocked the loading of a resource at self (“script-src”).
Re:How to teach Git by hyperpallium on Wednesday January 16, 2019 @07:01PM (#18926949)
Good to see tax accountants contributing to open source.
Re:How to teach Git by zwieback on Wednesday January 16, 2019 @04:07PM (#18925261)
Love it. I'm sold on git but it often feels like I'm in one of those man pages.
Re:How to teach Git by LyndsySimon on Thursday January 17, 2019 @03:24PM (#18934257)
In my experience, it gets better. After a while you know everything you need to not only do your job, but to understand and resolve common issues. After a couple of years you'll be at the point where the only time you have to dig through manpages is when you're trying to do something esoteric or clever.
Re:How to teach Git by arduinomancer on Wednesday January 16, 2019 @02:05PM (#18923860)
That's hilarious
Re:How to teach Git by mrzool on Wednesday January 16, 2019 @03:19PM (#18924682)
Nothing short of sublime. Thanks for sharing.
Re:How to teach Git by paultopia on Wednesday January 16, 2019 @07:13PM (#18927057)
OMG THIS IS THE REALEST
Re:How to teach Git by philbarr on Wednesday January 16, 2019 @10:45AM (#18921785)
That's fantastic!
Re:How to teach Git by ppezaris on Wednesday January 16, 2019 @04:55PM (#18925812)
oh my sides.
Re:How to teach Git by sonnyblarney on Wednesday January 16, 2019 @11:45PM (#18928447)
This is funny, but in reality it's not.

Git is one of the most amazing, powerful tools ever conceived, with one of the must byzantine and ridiculously designed 'interfaces' ever conceived.

People confuse the raw power of a tech, with how well it can be feasibly used. Sadly, due to the later issues, git will only ever be a shadow of what it could have been.

With all due respect to Linus, who'd be the first to admit he's not very good at UI stuff (I mean command line as well)... it's truly a sad thing.

This is a major 'problem that needs to be solved' I'm interested to see how it could evolve into something 'better'.

Re:How to teach Git by karmakaze on Thursday January 17, 2019 @07:31AM (#18930246)
I don't think the complexity of git's command options is a UI problem. It results from the basis of its operation. We could change some names, add or remove some concepts to how some of the operations are performed, but there are simply a large number of actions to handle many edge cases.

A better solution for prose was to always be merging with live multiple collaborator updates. Conflicts are visible in real-time. I can't see something like this would work with code. Hmm interesting... unless we only allow additions and refactorings to working checkpoints.

Re:How to teach Git by P_I_Staker on Thursday January 17, 2019 @09:34AM (#18930996)
Yes, I don't really understand all the people trying to "fix git". Git's fine, though the complexity makes it challenging, especially for new users. However the complexity is a direct result of useful features. "Keeping it simple" is great, except when the complexity is needed. I'm hard pressed to name any features I could do without.
Re:How to teach Git by sonnyblarney on Thursday January 17, 2019 @11:35AM (#18932145)
There are two problems: one of inherent complexity, one of UI.

First - the UI is a mess, and that should have been fixed. It would make a big difference.

Second - is the inherent complexity. That's a good point, but I feel many things could be hidden or obfuscated.

Most poignantly, Git does something that most of us do not need: it was designed to work as a 'completely distributed system', i.e. for open source.

Almost none of us do that. 95% of uses cases related to you and I working collaboratively, on a project together.

The need to have repos which are essentially totally distinct from one another is a huge source of complexity and it simply doesn't need to exist in most cases.

So Git is basically an 'admin level tool' that is commonly used in scenarios for which it wasn't meant to be used, with a confusing interface.

It's costing a lot of time and money and headaches, I do believe someone may come along eventually and fix it.

This thread is essentially evidence of this - see how many people have difficult teaching what should essentially be a simple thing in most cases.

Way too many very smart people still spend too much time clustering around in git.

Re:How to teach Git by fiblit on Thursday January 17, 2019 @11:44AM (#18932237)
Ever used a centralized VCS, such as SVN? That seems to be what you want? A distributed VCS is extremely useful, for mine and many others' uses, however.
Re:How to teach Git by romwell on Thursday January 17, 2019 @04:42PM (#18934922)
>I'm hard pressed to name any features I could do without.

Nobody is complaining about there being too many features. People are complaining about the arcane incantations that one needs to conjure to call them.

Re:How to teach Git by P_I_Staker on Thursday January 17, 2019 @05:52PM (#18935426)
Good point. I wouldn't say nobody though. There are people out there that think there are too many commands. I've even seen academic papers that claim the staging area is problematic. I love the staging area, and don't think it's terribly confusing; there's always commit -a if you don't want to use it. It does lead to some confusion, but it's worth it for the added features.

That's just one example, but there definitely are people that think git's too featureful. As for more valid criticisms, I'd agree. I've heard the CLI compared to being in an abusive relationship. All that said, I can't really think of a better way to handle things without losing useful functions. In which case, I don't have any better ideas, and don't really know what I'm criticizing.