On 18 July 2011 03:55, Philip Olson <phi...@roshambo.org> wrote: > Hello everyone, > > Our credits system is not ideal so let's talk about it. A few points: > > - Most people on the front page aren't active > - We don't know what it means to be on the front page, or why separation > exists > - We also don't know what it means to be listed within the preface > - And, what is an editor? I'm one and don't even know > > Now, that of course oversimplifies it but let's continue. > > Goals of the credits system: > > - To give people proper credit for their work > - To let people know who writes this stuff, both past and present > - To provide incentive to work on the PHP Manual > - To be real > > Statistics based: > > Commit statistics are often misleading. Converting line endings, adding svn > props, creating skeletons, and stuff like that should count less than a > well-written paragraph or bug fix. And commit statistics don't apply to > people who do other work like maintain infrastructure (chm, builds, etc.) as > they don't involve commits. > > Jumbled based: > > This mixes everyone together, so a person who made one commit 23 months ago > sits next to a guy who commits every day. Something about this also feels > wrong, but also right. > > Now what: > > Think it over and let's determine if our current system can be improved, and > how. > > My opinion: > > Maybe an alternative or hybrid could exist, but I lean towards throwing all > names together into the preface, which essentially means removing all names > from the front page. And secondly, we can lose the editor role and also throw > them into the mix. We all work and edit. I think our current definition of > editor is an "old timer who promises to remain active" but we have plenty of > those. Something to think about. > > Also, an improved people.php.net could link to sites like ohloh.net, and also > display a statsvn.org instance. This, however, goes beyond the documentation > credits but it's also something to consider. > > >
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.). -- Richard Quadling Twitter : EE : Zend : PHPDoc @RQuadling : e-e.com/M_248814.html : bit.ly/9O8vFY : bit.ly/lFnVea
