Benji Fisher <benji@xxxxxxxxxxxxx> writes:
> I was under the impression that the new "git switch" and "git restore"
> commands were recommended in most cases instead of "git checkout".
These two were added so that eventually we have something we can
recommend to new users, but as a pair of experimental commands, we
reserve the rights to update their UI in backward incompatible ways
(meaning: those who use them may need to retrain their fingers and
update their scripts if they used them---not that using these
Porcelain commands in scripts is a good idea to begin with).
So your justification could be
We want to evantually be able to recommend restore/switch to new
users, and want to take advantage of every opportunity to polish
them.
Because this document is not exactly for totally new users, and
the readers are expected to be knowledgeable enough and highly
motivated in improving git, let's have them use these
experimental commands and report newbie-issues they found using
them, so that we can gain more experience and chances to polish
the command and eventually make them recommendable to new users.
Note that the "WHY?" in my response was not "I see no reason to do
this", but "You need to say why you think this is a good idea here
in the proposed commit log message". Without your version of
reasoning, my conclusion was "I do not see a point", but with a
justification like this (there could be others---it is contributor's
job to explain why a proposed change is a good idea, not mine), I
can understand the reasoning why this change may be a good one.
Thanks.
