News for hackers. Stuff that matters.
Re:Write yourself a Git (2018) by cabalamat on Thursday March 14, 2019 @08:05AM (#19388434)
> Your idea of a "user's mental model" might land you into trouble though

If I do do this, I will explicitly lay out the user's metal model in the documentation at the start. Then it will be the user's fault if they can't be bothered to read it.

Re:Write yourself a Git (2018) by huffstler on Thursday March 14, 2019 @09:28AM (#19389004)
While gits documentation might not lay out the model at the start, they certainly have documentation showing how everything works, complete with diagrams and such. As such...

> Then it will be the user's fault if they can't be bothered to read it.

can be applied to you about git technically. I think that's just me being a "little" pedantic though.

It sounds like the issue you actually have is that the documentation isn't easily readable in one or two sittings, and you don't have the time (or can't be bothered) to go through it and learn it. Which I totally understand, everyone has different things they need to spend time on, most of the time learning Git isn't one of them.

Re:Write yourself a Git (2018) by cabalamat on Thursday March 14, 2019 @07:48PM (#19395078)
> can be applied to you about git technically.

I have read large parts of the git docs. I don't like them. This is not just the text: the low contract colours and hard-to-read fonts are also factors.

> It sounds like the issue you actually have is that the documentation isn't easily readable in one or two sittings, and you don't have the time (or can't be bothered) to go through it and learn it.

So how long should it take to learn a VCS? And how long does git take to learn?