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
