|
|
Re: Cast of Characters and Credit: msg#00082
|
Subject: |
Re: Cast of Characters and Credit |
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
|
| |