From: Junio C Hamano <gitster@pobox.com>
Date: Thu, 10 Mar 2011 23:09:43 GMT
Subject: Re: [PATCH 2/2] Add Author and Documentation sections to git-for-each-ref.txt
Message-ID: <7v4o7a3748.fsf@alter.siamese.dyndns.org>
In-Reply-To: <20110310223732.GE15828@sigill.intra.peff.net>

Jeff King <peff@peff.net> writes:

> On Wed, Mar 09, 2011 at 12:17:53PM -0800, Junio C Hamano wrote:
>
>> As the project and the community grew, and also as the internal machinery
>> infrastructure got more modularized, I think ownership at the individual
>> command level has become almost meaningless concept.
>> 
>> Same reasoning applies to the "Documented by".  I think it's time for
>> these two sections to go from most (if not all) pages.
>
> Yeah, I would just as soon drop Author and Documented-by fields in all
> manpages. We could replace them with a single "Credits" in git(1). It
> can either mention nobody, very few people (like Linus as the originator
> and Junio as the long-time maintainer), or the top N (for N < 20 or so)
> people in shortlog. And then mention that you can run shortlog yourself.

Sounds sensible.