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