Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update remote-branches.asc #1558

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Update remote-branches.asc #1558

wants to merge 1 commit into from

Conversation

Leative
Copy link

@Leative Leative commented Nov 10, 2020

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

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.
@ben
Copy link
Member

ben commented Jul 3, 2021

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants