Skip to content

Commit 6690882

Browse files
authored
fix: description of Pull Request comparison
1 parent ee0b757 commit 6690882

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

content/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-comparing-branches-in-pull-requests.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -73,11 +73,11 @@ For more information about Git commands to compare changes, see [Git diff option
7373

7474
## About three-dot comparison on {% data variables.product.prodname_dotcom %}
7575

76-
Since the three-dot comparison compares with the merge base, it is focusing on "what a pull request introduces."
76+
Since the three-dot comparison compares with the merge base, it is focusing on the differences between the latest common commit of the topic branch and the base branch.
7777

78-
When you use a two-dot comparison, the diff changes when the base branch is updated, even if you haven't made any changes to the topic branch. Additionally, a two-dot comparison focuses on the base branch. This means that anything you add is displayed as missing from the base branch, as if it was a deletion, and vice versa. As a result, the changes the topic branch introduces become ambiguous.
78+
Note, that with three-dot comparison, the diff changes when the base branch is updated, even if you haven't made any changes to the topic branch, because the diff shows all of the changes since the branches diverged. Additionally, a three-dot comparison focuses on the base branch. This means that anything you add is displayed as missing from the base branch, as if it was a deletion, and vice versa. As a result, the changes the topic branch introduces become ambiguous.
7979

80-
In contrast, by comparing the branches using the three-dot comparison, changes in the topic branch are always in the diff if the base branch is updated, because the diff shows all of the changes since the branches diverged.
80+
In contrast, by comparing the branches using the two-dot comparison, only the changes in the topic branch would show in the diff if the base branch is updated, because the diff will only show the actual changes between the branches.
8181

8282
### Merging often
8383

0 commit comments

Comments
 (0)