-
Notifications
You must be signed in to change notification settings - Fork 2k
Description
Which version of the book is affected?
This affects our mainline branch, when macOS and Debian stable include newer versions of Git that have the git switch
command.
Describe the bug:
When stable platforms use newer versions of Git, we should not be using git checkout
as the recommended way to do things, and instead promote git switch
usage.
Steps to reproduce:
Just look through the book and note that we use git checkout
instead of git switch
.
Expected behavior:
What the rewrite should do:
- Get rid of the
[NOTE]
that pull Create note forgit switch
#1523 introduced. - Rewrite book to use
git switch
instead ofgit checkout
where possible. - Add
[NOTE]
explaining thatgit checkout
is the "old way" of doing things.
Screenshots:
Additional context:
From @ben at #1515 (comment):
We can rewrite to recommend
switch
first andcheckout
as a note when MacOS and (apparently) Debian stable have newer versions.
From @Paebbels:
When Git 2.27+ is bundled with most common distributions (e.g. Debian stable), the usage of
git checkout
can be degraded to a foot note or so.
I copied/pasted @ben's words, so that we can keep track of this issue here, instead of on a issue (#1515) that will be closed when my pull is merged.