Re: Cast of Characters and Credit

James Britt <[email protected]> Wed, 30 Aug 2006 16:26:32 -0700
Newsgroups gmane.comp.lang.ruby.documentation
Organization ruby-doc.org
Message-ID <[email protected]>
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.

James