Incorrect description of git pull behavior in Chapter 3.5 of Pro Git book V2

オープン
#1,962 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
1/5
見積もり時間
1時間未満
初心者へのやさしさ
58/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
停滞
技術スタック
git
領域
documentation

調査の方向性

Locate the Pro Git v2 source for Chapter 3.5, “Git Branching - Remote Branches,” and find the “Pulling” section. Update the statement so it clearly says that git pull merges the fetched remote branch into the current local branch, then verify the wording in the generated book output.

索引モデルが issue の本文から書いたものです。

説明

bug
There's no existing/similar bug report.
  • I have searched the existing issues
This report is about a single actionable bug.
  • I'm reporting a single actionable bug
This report is about the ProGit book, version 2, English language.
  • This bug is not about a translation or old version
Bug covers book website/pdf
  • I confirm the bug is about the book as found on the website/pdf
Problem is present in the Pro Git book on the website?
  • This bug also affects the Pro Git book as published on the website.
Which version of the book is affected?

Source files

Describe the bug:

The Pro Git v2 book contains a misleading statement about the behavior of git pull in Chapter 3.5
link: https://git-scm.com/book/en/v2/Git-Branching-Remote-Branches

The current statement is:

"git pull will look up what server and branch your current branch is tracking, fetch from that server and then try to merge in that remote branch."

This implies that the merge happens in the remote branch, which is incorrect. The correct behavior is that the merge happens in the local branch.

Steps to reproduce:
  1. Go to https://git-scm.com/book/en/v2/Git-Branching-Remote-Branches
  2. Scroll down to "Pulling" section
  3. See error
Expected behavior:

Current Statement:
"git pull will look up what server and branch your current branch is tracking, fetch from that server and then try to merge in that remote branch."

Corrected Statement:
"git pull will look up which server and branch your current branch is tracking, fetch from that server, and then try to merge that remote branch into your current local branch."

Screenshots:
Screenshot 2024-06-23 at 13 24 02
Additional context:

Location:
Chapter 3.5, Section Pulling
Link: https://git-scm.com/book/en/v2/Git-Branching-Remote-Branches

Device

desktop

Operating system

macos

Browser/application + version

google chrome

主要言語
CSS
スター
6.6k
フォーク
2.1k
PR マージ指標
30日以内にマージされた PR はありません

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

progit/progit2 のほかの issue

progit/progit2 の issue をすべて見る

似ている issue

Documentation の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。