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