Start from http://www.docbook.org/tdg/en/html/authorgroup.html to get more information on the tag and possible parents.
For translated versions, the nicknames can be fetched from the Revision comments, where those are appropriately specified. For the original English text, everything not added by Hartmut [who have done file splits, movearounds] can probably be credited to the first committer.
For the other files, people should just complain that they added it, and it can be done by hand (they provide a link to their commit). For the language, tutorial, and other sections it can be done by hand for now.
I don't know if this is a good idea... Having a tag in every file? And what names would be listed? The original writer of the file? The guy who added some examples? The guy who fixed some bugs on that file?
All guys who provided significant value in the contents of that section.
Isn't easy! I would vote to have all names together somewhere in the documentation (frontpage, appendix,....).
It's not easy to do all at one time but it would be a good method in the future to add docs this way and update older docs with author info as time permits. PEAR people generate their author list somehow similarly if I understand correctly.
The author information detailed above is used to print out the author's name on individual documentation pages in the footer with a small font. If there is no author info section for a specific page in the XML file, then the author[s] of the parent is shown.
The author info will also be used to generate a full listing of every contributor involved in the documentation process. This list will be presented on the bookinfo page. For translations, the translators names will show below the authors in a separate section.
History should be preserved/maintained in all the crediting systems involved.
The idea here was to use livedocs to display the author along with the file revision AFAIK. As I stated before, I think isn't really need to have so much credit.
It is easier to give credit on a fine grained scale, since then even people providing relatively small amount of additions will get listed.
The idea of presenting the author of the PHP extension itself also came up, and was generally agreed on. The documentation system can grab the list of authors from the php-src/EXTENSIONS file, and will generate extension specific author information by the side of the documentation authors' list.
Yes, we may add the authors... And what about update the names in phpinfo()? :-)
It is not possible to list all authors and contributors in the phpinfo() output - also including all note maintainers. So once we see the list we would like to include here, we need to decide on a method to choose the list of people who are going to go to the phpinfo() page (and a 'more' link should be there :)
Goba
