Re: git help clone: questions
- Date: Mon, 05 Mar 2018 17:36:56 -0800
- From: Junio C Hamano <gitster@xxxxxxxxx>
- Subject: Re: git help clone: questions
kalle <kalle@xxxxxxxxxxxxxxxxxxx> 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..."