Re: Starting a "howtohelp"/"contributing" sets of book

On 13 Mar 2009, at 14:22, Daniel Convissor wrote:

On Fri, Mar 13, 2009 at 07:12:10PM +0100, Hannes Magnusson wrote:

I'd like to start a "how to help"/"contributing" set of books covering how to particpate in the various php projects (pecl, qa, phpdoc, src...).

...

move phpdoc/howto into phpdoc/en/contribute/phpdoc

That sounds like a very good idea. I've always thought it peculiar that the manual didn't have a contribute section, meaning folks wanting to contribute have to go scrounging all over the place. Similarly, it will be helpful to migrate information from the Wiki.

Such a place exists: http://php.net/about.howtohelp So the difference is it lacks some clarity and simply points to the HOWTO instead of including it. However, the clutter is true and unfortunate. The main HOWTO is rather bulky and isn't fun to play with, whereas new wiki entries are new, simple and shiny. Not that this makes it right, but at least for me it helped promote and create the chaos that exists today. A few related wiki entries: Specifics that PECL geeks should care about: - http://wiki.php.net/doc/scratchpad/pecldocs Specific information for translators: - http://wiki.php.net/doc/scratchpad/howtotranslations Shorter version of the main HOWTO: - http://wiki.php.net/doc/scratchpad/howto So, how about we create this contribute set and start work on the other howto's in there like for qa, pecl, php-src, and see what happens. And once the structure is known and defined move the relevant phpdoc howto content there. I think simply throwing it in there won't add any benefit but will instead be a hindrance. Regards, Philip