Skip to content

Rewrite recommend git switch instead of git checkout #1524

@HonkingGoose

Description

@HonkingGoose

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 for git switch #1523 introduced.
  • Rewrite book to use git switch instead of git checkout where possible.
  • Add [NOTE] explaining that git checkout is the "old way" of doing things.

Screenshots:

Additional context:

From @ben at #1515 (comment):

We can rewrite to recommend switch first and checkout 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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions