Re: finally: new authors

From: Date: Sat, 03 May 2003 19:32:46 +0000
Subject: Re: finally: new authors
References: 1  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969353105@lists.php.net to get a copy of this message
On Sat, 2003-05-03 at 14:26, Jesus M. Castagnetto wrote: > Indeed note editing has not been much of a recognized > position, and along the years not many have been aware > of the php-notes list. The current system for note > editing (a mix of some of my old code and a lot of > nice enhancements by Jim) makes life easier for the > editors. > > One thing that should be interesting, and has not been > implemented, would be to allow note editors to > register interest in a particular chapter/section and > then recieve only those notes. I wrote code to that > effect but I am not sure where it is right now after > 'phpweb' as reorgnized. You mean 'note alerts'? There is some mis-matched code lying around php-master-web. I think that having a php-notes mailing list > > To come back to the topic, it might be more > interesting to have: > > 1) The manual editors in the main page (TOC) of the > manual. Those will be the people that will be > contacted with stuff regarding the organization of the > manual, or licencing questions, etc. As mentioned in the 'list of contributors [rethought]' thread, I think that having one page with credits is better than having some people on the front page and some on the credits page. Just putting everybody into groups on one credits page seems easier. > > 2) Perhaps list the last 4 or 5 people commiting > changes to a particular page, and list them as > authors. This might require some CVS wizardry included > in the manual building process. I don't like this idea, really. Should people that just fixed a typo really be considered an author? Plus, some commits that effect the whole tree (harmut's banana split, adding a revision tag, etc..) would make that one person an author for every page. I still favor a single credits page. > > 3) An appendix listing the people that have > contributed to the manual with some stats, and pages, > that way if someone wants to contact the writer to > suggest improvements or corrections, that page will > make it simpler. As discussed in the 'list of contributors [rethought]' thread, a top committers list really isn't a good idea. -- Andrew Lindeman <alindeman@php.net>

« previous php.doc (#969353105) next »