Re: finally: new authors

From: Date: Sat, 03 May 2003 19:26:54 +0000
Subject: Re: finally: new authors
References: 1  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969353102@lists.php.net to get a copy of this message
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. 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. 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. 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. IMHO, (1) is simpler to implement, (2) can be obtained from a file generated automagically from the CVS logs which is created periodically, (3) can also be done that way. Of those, I think (3) is optional. Comments? --- Andrew Lindeman <alindeman@php.net> wrote: > How about something like a notes editor? I know I > spend a good bit of > time going through the manual and deleting stupid > notes and sometimes > adding notes to the manual proper. Obviously, this > may not be as worthy > of recognition as some other positions, but it is an > important part of > the manual up-keep. > > --Andrew > > On Fri, 2003-05-02 at 09:32, Gabor Hojtsy wrote: > > Hi! > > > > As the documentation license is changed, and the > current authors agreed on > > adding more contributors to the list of authors / > editors, I would like to > > ask everybody to think of proposing himself or > anybody else to be an author > > or editor. For now I think we can make this with > voting, and in case of > > anybody has objections against someone then we > need to go deeper into that > > questions. Is this ok? > > > > I would like to avoid proposing too much guys > myself, as I would probably miss > > some important figures, and would be shamed ;) So > please don't be shy and > > propose who you think deserves to be on the > authors / editors list. > > > > I myself would like to propose a new role > 'Technical editor' or something like > > this, which would fit for me and Hartmut too (in > case he agrees) and Jouni > > can also be moved there (in case he agrees of > course). This role would be for > > those who work / worked mainly on the technical > staff behind, and not > > primarily on the content, which as far as I see is > the case for me, Hartmut > > and Jouni. > > > > I am not going to propose anybody else here, > though I know there are many guys > > who deserve to be listed as authors / editors. > Jump up and say! :) And also > > feel free to shout out any objections. > > > > Goba > -- > Andrew Lindeman <alindeman@php.net> > > > -- > PHP Documentation Mailing List (http://www.php.net/) > To unsubscribe, visit: http://www.php.net/unsub.php > ===== --- Jesus M. Castagnetto <jmcastagnetto@php.net> __________________________________ Do you Yahoo!? The New Yahoo! Search - Faster. Easier. Bingo. http://search.yahoo.com

« previous php.doc (#969353102) next »