On January 9, 2023 2:17 PM, Eric Sunshine wrote: >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. I agree. Perhaps it is time to drop the "EXPERIMENTAL" notices from 'git switch', in that case.