Web lists-archives.com

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