Re: PATCH: improve git switch documentation

From: Sergey Organov <sorganov@gmail.com>
Date: Jul 11, 2021, 14:49 UTC
Message-ID: <87sg0kewi2.fsf@osv.gnss.ru>
In-Reply-To: <33af677c-8fec-5b49-0e00-878918c4ea1d@mfriebe.de>

Martin <git@mfriebe.de> writes:

> On 11/07/2021 14:23, Sergey Organov wrote:

[...]

Show 12 quoted lines

>>>> Once that is regularized, we may as well consider allowing for inverse
>>>> order of the first 2 arguments, by making
>>>>     git new remote
>>>>     git remote new
>>>> the synonyms.
>>>
>>> Having even more ways to do one and the same thing....
>> Python was aiming to have one obvious way of doing every single thing...
>> Did it succeed in that, I wonder? Maybe this aim is only good in theory?
>
> We are way away from having "one single way". But aiming for the
> extreme opposite may not be any smarter.

I don't like extremes either, but when there is a choice, there should be at last a stated preferred way of doing things. Guidelines, if not the rules. Otherwise we end up with an ugly mix of random preferences of different authors.

Show 13 quoted lines

>
> While there is nothing wrong with going our own way in the end, maybe
> we should look around before?
>
> How do other vcs do it?
>
> svn has at least status and log, which I would consider nouns, the way
> they are used. And it has verbs too.
>
> hg as "branches", "files" which are nouns. And "log".
> And it has verbs too.
>
> So there seems to be a pattern to using "mixed" verbs and nouns.

There are so many things they did wrong... This could well be just another one.

Thanks,

-- 
Sergey Organov