From mboxrd@z Thu Jan  1 00:00:00 1970
From: Junio C Hamano <gitster@pobox.com>
Subject: Re: [PATCH v3 0/2] Re: user-manual: general improvements
Date: Thu, 21 May 2009 07:14:02 -0700
Message-ID: <7vvdnubl1x.fsf@alter.siamese.dyndns.org>
References: <1241650416-12224-1-git-send-email-felipe.contreras@gmail.com>
	<20090507072326.GA13123@vidovic>
	<7veiv0cvdt.fsf@alter.siamese.dyndns.org>
	<20090508042814.GA30031@vidovic>
	<94a0d4530905131430q2250a43ei692265c3f32b5715@mail.gmail.com>
	<20090514160609.GA12910@vidovic>
	<7vvdnvtf2n.fsf@alter.siamese.dyndns.org>
	<20090521041529.GD8091@sigill.intra.peff.net>
	<94a0d4530905210017x1ce3e32bk3b1fbf9044377763@mail.gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Cc: Jeff King <peff@peff.net>, Nicolas Sebrecht <nicolas.s.dev@gmx.fr>,
	git@vger.kernel.org
To: Felipe Contreras <felipe.contreras@gmail.com>
X-From: git-owner@vger.kernel.org Thu May 21 16:14:19 2009
Return-path: <git-owner@vger.kernel.org>
Envelope-to: gcvg-git-2@gmane.org
Received: from vger.kernel.org ([209.132.176.167])
	by lo.gmane.org with esmtp (Exim 4.50)
	id 1M792E-0000Gk-1N
	for gcvg-git-2@gmane.org; Thu, 21 May 2009 16:14:14 +0200
Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand
	id S1753730AbZEUOOE (ORCPT <rfc822;gcvg-git-2@m.gmane.org>);
	Thu, 21 May 2009 10:14:04 -0400
Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1753548AbZEUOOC
	(ORCPT <rfc822;git-outgoing>); Thu, 21 May 2009 10:14:02 -0400
Received: from fed1rmmtao104.cox.net ([68.230.241.42]:56514 "EHLO
	fed1rmmtao104.cox.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org
	with ESMTP id S1753196AbZEUOOB (ORCPT <rfc822;git@vger.kernel.org>);
	Thu, 21 May 2009 10:14:01 -0400
Received: from fed1rmimpo02.cox.net ([70.169.32.72])
          by fed1rmmtao104.cox.net
          (InterMail vM.7.08.02.01 201-2186-121-102-20070209) with ESMTP
          id <20090521141402.GOA17135.fed1rmmtao104.cox.net@fed1rmimpo02.cox.net>;
          Thu, 21 May 2009 10:14:02 -0400
Received: from localhost ([68.225.240.211])
	by fed1rmimpo02.cox.net with bizsmtp
	id uEE21b00D4aMwMQ04EE21C; Thu, 21 May 2009 10:14:02 -0400
X-Authority-Analysis: v=1.0 c=1 a=YDhzBoFtm8wA:10 a=AYFEWzs_8uQA:10
 a=pGLkceISAAAA:8 a=VawBOTHkZ2CknJefiPQA:9 a=bSrL-RkIrNIPyCNBGUD0l6QE8g4A:4
 a=MSl-tDqOz04A:10
X-CM-Score: 0.00
In-Reply-To: <94a0d4530905210017x1ce3e32bk3b1fbf9044377763@mail.gmail.com> (Felipe Contreras's message of "Thu\, 21 May 2009 10\:17\:45 +0300")
User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.2 (gnu/linux)
Sender: git-owner@vger.kernel.org
Precedence: bulk
List-ID: <git.vger.kernel.org>
X-Mailing-List: git@vger.kernel.org
Archived-At: <http://permalink.gmane.org/gmane.comp.version-control.git/119681>

Felipe Contreras <felipe.contreras@gmail.com> 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.