Re: finally: new authors

From: Date: Tue, 06 May 2003 23:07:53 +0000
Subject: Re: finally: new authors
References: 1  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969353223@lists.php.net to get a copy of this message
Hello all! I've been away this weekend and find this enormous thread in my inbox, woah! After reading these posts here are are my general feelings on the postings, just to catch up :) First my gut is against listing everyone and rather see a short list. Listing everyone who has done anything seems crazy to me, too much work, too much stress. I've yet to see anyone propose a sane way to do this. Just think of all the bug squashers and code committers over at php-dev that lack credit. And how full of stale users this list would be. Not having this list will provide those wanting this credit to work even more on the manual to get on the short list. But I'm guessing most people don't care and occasionaly commit out of thanks to PHP for existing. Or simply for other reasons like a coder using the manual finds a function that needs a clearer explanation or better example. I know this is the reason for my first commit, I kept on forgetting if the strip_tags() allowable_tags parameter used a comma for tag separation or not so I entered in an example for my own reference. After utilizing this documentation I was hooked :) And here we are, almost two years later, so I guess it's time I be mentioned somewhere. I didn't think I deserved a mention after a month though, or even after three, and still feel this way. Just another anonymous guy helping out on one of a million open source projects out there. How about we start small and see how it goes. Going from no credits in three years to massive everyone get credit now is too much change. Someone mentioned a worry about people leaving or not working on the manual due to lack of credit. Granted lack of mass credit might mean a few less commits to the phpdoc tree but so be it. Is this the best reason to contribute? Here's something we all can do to get a credit. Create a little phpdoc resume that shows what was done, this will be on a personal website and not in phpdoc. As this resume grows everyone will take notice. Spend your own time promoting yourself and not force other humans or some statistics engine to do it for you. Also use this to show the documentation team what is up. Just because live humans are required to monitor and list credits doesn't mean it'll get personal or turn into some huge political game. Everything will be openly discussed on this list. If this is a problem consider hiring a new lawyer or political advisor! Quality work speaks louder than statistics and humans understand quality much better than computers. Take a course on statistics to prove this point. Now if someone creates a setup that shows statistics then we can use that as a bonus but it certainly will never be the baseline to any credits system. I would look forward to creating a "How to make yourself look important through phpdoc statistics" white paper. ;) Regards, Philip

« previous php.doc (#969353223) next »