On Mon, Jul 18, 2011 at 06:09, Richard Quadling <rquadl...@gmail.com> wrote:
>
> With the introduction of http://www.php.net/humans.txt, maybe this
> could be a good place to store everyone and their level of
> contribution. Not just for PHPDoc, but the entire PHP project,
> including PhD, PEAR and PECL, and infrastructural stuff too (servers,
> buildtools, online editor, etc.).
If it were up to me to come up with an idea, I would have it
auto-built, once per month, to dynamically include all names of folks
who committed within the preceding month, perhaps with a minimum
number of commits. Then, instead of alphabetically, it could be
measured by either number of commits or total number of bytes.
It wouldn't be perfect, but it would show a fairer representation
than now, because - as Philip mentioned - a good number of folks there
are barely active with the documentation, if even at all. A dynamic
build would be "real-time," and folks who have made a significant
impact on the docs (and perhaps those names there now) could be
statically-posted in a "thanks also to...." section or something of
the like.
As for others, such as CHM and user note maintainers, separate
sections could also be built statically or dynamically. For user
notes, at least, the data is already available[1], and for other
stuff, the users involved don't change very often.
I think things like infrastructure are more all-encapsulating, and
not necessarily worthy of inclusion in the documentation. Sure,
credit is nice, but not only is measurement of those activities tough
to fairly "credit-compensate" someone for work they've done in
relation to that of the group, I think it would also serve to attract
unwanted attention. Meaning, if someone sees they can get their name
in the manual just for having access to a system, that could keep
their name there indefinitely, while they do nothing more than
maintain the login. If anything, a separate page for network managers
on the wiki would suffice, or at most on the main site under a new
credits page.
Lastly, on a related note to the point in the last paragraph, the
credits page is horribly askew across the network. Because it uses
phpcredits() to display the information, it can vary quite widely
depending on the version of PHP used by the mirror on which one views
the page. That page, I believe, should be statically-built weekly
using the latest credits data, and included in the mirrors kit. If no
one has any objections to that, I'll gladly put a cron job on master
to handle it this week.
^1: http://doc.php.net/php/notes_stats.php
--
</Daniel P. Brown>
Network Infrastructure Manager
http://www.php.net/
