Re: [PATCH v3 0/2] Re: user-manual: general improvements

From: Junio C Hamano <gitster@pobox.com>
Date: May 21, 2009, 16:10 UTC
Message-ID: <7v8wkqbfnr.fsf@alter.siamese.dyndns.org>
In-Reply-To: <94a0d4530905210900xa464f75se2bd2bf3d8103b10@mail.gmail.com>

Felipe Contreras <felipe.contreras@gmail.com> writes:

> The "guidelines" (not rules) I followed are a bit hard to explain,
> I'll try to do that, but in the meantime would you deny that the patch
> actually makes things a bit more consistent?

Well, until you spell out what your rules are to decide how things should be marked up (e.g "command name in prose should be spelled inside sq pair, like 'git frotz'"), I assert that I cannot even judge if the result of the patch is consistent with them. I can only say "wooo, most of the branch names look green" or something like that, but that kind of comment on the consistency is as useful to you as "ahh, everything is spelled in American spellings", iow, not much, isn't it?

Getting everybody agree to the rules is a different matter, but that happens only after everybody knows what the rules are.