From: Junio C Hamano Date: Thu, 21 May 2009 14:14:02 GMT Subject: Re: [PATCH v3 0/2] Re: user-manual: general improvements Message-ID: <7vvdnubl1x.fsf@alter.siamese.dyndns.org> In-Reply-To: <94a0d4530905210017x1ce3e32bk3b1fbf9044377763@mail.gmail.com> Felipe Contreras writes: >> Maybe this was even discussed earlier in the thread (I didn't go back to >> look), but it should definitely be part of the commit message. > > The rule I followed is: change it to whatever looks best. "Looks best to me" is not something other people can follow to replicate the examples you set here to further "clean up" other parts of the documentation set or writing new sections to the document you touched up with this patch. I suspect that you would not deny the possibility of saying "The result looked better when I last looked at it, but now I think about it I do not know why I thought it looked better" three months down the line. It is not a rule.