From: Junio C Hamano <gitster@pobox.com>
Date: Tue, 06 Mar 2018 01:36:56 GMT
Subject: Re: git help clone: questions
Message-ID: <xmqqinaa6l3b.fsf@gitster-ct.c.googlers.com>
In-Reply-To: <6ea2b41f-37c3-8540-4763-7688f56fe202@projektwerkstatt.de>

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..."