From: kalle <kalle@projektwerkstatt.de>
Date: Wed, 07 Mar 2018 22:30:39 GMT
Subject: Re: git help clone: questions
Message-ID: <81c78c4f-b690-d06c-bb7d-9c65e33777b5@projektwerkstatt.de>
In-Reply-To: <xmqqinaa6l3b.fsf@gitster-ct.c.googlers.com>

I wrote this, because when it is written about 'reference repository', I
consider it not totally clear, which repository is meant, as the option
'--reference <repository>' only names one as <repository>.
For reasons of clearness, I now propose writing "reference repository
<repository>".

kalle

Am 06.03.2018 um 02:36 schrieb Junio C Hamano:
> kalle <kalle@projektwerkstatt.de> writes:
> 
>> -In the explanation of the option --reference: shouldn't there be
>> written '<repository>' instead of  'reference repository'?
> 
> "Shouldn't X be Y?" is not an effective way to communicate; it
> solicits a "no, the current one is fine." without any explanation.
> 
> If you think X should be Y for some reason, please say "I think X
> should be Y BECAUSE Z" instead.  Without stating why you think
> differently from what those who wrote the current text, it is hard
> for people to respond either with "Yeah, you're right---I agree
> with Z" or with "No, Z does not hold because..."
>