progit2 icon indicating copy to clipboard operation
progit2 copied to clipboard

Update remote-branches.asc

Open Leative opened this issue 5 years ago • 1 comments

Changes

  • adapted terms and explanations with regard to the differences between remote branches, remote-tracking branches and tracking branches

Context

The document differentiates between remote branches, remote-tracking branches and tracking branches. I tried to fix some ambiguities which could, in my opinion, be misleading.

Related #605

Leative avatar Nov 10 '20 14:11 Leative

Remember, Pro Git isn't a reference manual. It's meant to be a readable introduction to Git for people who have never used it before. So adding technical correctness at the expense of accessibility to newbies, especially in the first chapter where we talk about branches, doesn't fit.

Also worth noting here: "remote branch" and "remote-tracking branch" don't have an official definition per se. They're just refs to Git, so you can define them however you want. In this book we tried to define "remote branch" as "the local ref that represents the state of the ref on the remote," but we may have slipped a bit, and if that's the case it's worth fixing.

If you'd like to take another stab at this, I'll happily review it. I'd love to resolve some of the ambiguity we have here, but not at the expense of the beginner's experience.

ben avatar Jul 03 '21 00:07 ben