On Mon, Jan 9, 2023 at 6:20 AM <rsbecker@xxxxxxxxxxxxx> wrote: > On January 8, 2023 11:31 PM, Junio C Hamano wrote: > >"Yutaro Ohno via GitGitGadget" <gitgitgadget@xxxxxxxxx> writes: > >> Subject: Re: [PATCH] doc: use "git switch -c" rather than "git > >> checkout -b" consistently > > > >Hmph. When two things work equally well, is it a good idea to describe > only one > >"consistently", or mention both that can be used pretty much > interchangeably in > >different places? I am not 100% sure "consistently" is a good thing here. > > > >Thoughts from others? > > git switch is still marked as EXPERIMENTAL in the online help. I don't think > moving broadly to switch from checkout in the documentation should happen > until the EXPERIMENTAL designation is dropped. After that, then "switch -c" > should be used everywhere instead of checkout (except for in the checkout > documentation). Such a point probably should have been raised when 328c6cb853 (doc: promote "git switch", 2019-03-29) was submitted, but since 328c6cb853 was merged nearly four years ago and has been pointing people at git-switch all this time, it's probably too late to use it as an argument now.