Re: Cast of Characters and Credit

On Aug 30, 2006, at 4:26 PM, James Britt wrote:
> Eric Hodel wrote:
>> Maintaining a documentation ChangeLog per file will duplicate   
>> everyone's work.  There is no precedent and you'll force everyone  
>> to  scan through every file looking for committers.  Adding  
>> attributions  to the documentation per comment block will suffer  
>> from a magnitude  problem (how big a change is worthy of a  
>> mention?) and a clutter  problem.
>> The best place to list everyone's contributions is the ChangeLog.
>
> Quite true.  It's just that there are some people who have, and  
> continue to, been writing docs and I'd like them to get the props  
> they deserve.
>
> Trust me, I'm not looking to find more busy work or duplicate  
> information.  I just want a reasonable set of names so that when  
> people ask me, "So, who *is* writing all that doco?", I can tell them.

Here's a rough guestimate.  If we're missing names in the ChangeLog I  
can always backfill them.

$ grep -A1 -B1 -i doc ChangeLog | egrep -o '<[^>]+>' | occur
     2: <[email protected]>
     2: <drbrain at segment7.net>
     2: <meta at pobox.com>
     2: <[email protected]>
     1: <[email protected]>
     1: <gerardo.santana at gmail.com>
     1: <ksruby at gmail.com>
     1: <hgs at dmu.ac.uk>
     1: <tilman at code-monkey.de>
     1: <[email protected]>
     1: <sroberts at uniserve.com>
     1: <b>
     1: <ozgurmurath at gmail.com>
     1: <alex at blackkettle.org>
     1: <[email protected]>
     1: <florg at florg.net>
     1: </b>
     1: <[email protected]>
     1: <[email protected]>
     1: <lukfugl at gmail.com>
     1: <[email protected]>
     1: <calamitas at gmail.com>

-- 
Eric Hodel - [email protected] - http://blog.segment7.net
This implementation is HODEL-HASH-9600 compliant

http://trackmap.robotcoop.com