RE: [PHP-DEV] "waldschrotts guide to nifty references" - manualpagedraft, version 0.9b

From: Date: Sat, 19 Aug 2000 23:54:26 +0000
Subject: RE: [PHP-DEV] "waldschrotts guide to nifty references" - manualpagedraft, version 0.9b
References: 1  Groups: php.dev 
Request: Send a blank email to php-dev+get-29752@lists.php.net to get a copy of this message
> > Well, it's still a reference manual, despite a few exceptions in the > > features page (even though most of it is still reference-style). > > Anyway, whatever you call it, it's not the ultimate book of > > wisdom. Tutorials don't belong there. > > Why not? You are saying the tutorials do not belong on php.net? I have to agree with Rasmus here, having spent many hours trawling through the manual errata One of the main things I find are people asking for more indepth descriptions of how functions work, a tutorial of what this does, a more indepth example. Personally I dont think the manual is the place for this either but as Zend.com phpWizard.net phpbuilder.com etc have proved there is a need for these more indepth examples/tutorials, perhaps we should look at integrating some of these articles into a "book" and referece it from the manual, now these would need to be placed on php.net (Hopefully along side the current manual) and not left on their home sites or we will end up with lots of 404's. I personally feel we should not ignore the feedback we have via the errata and that feedback is the manual is lacking in indepth discussions of usage. Anyway just my $0.02 Also perhaps we should try and get as many as possible of these undocumented functions documented before investing hours into somthing that is not 100% necessary but "would be nice to have". There are only so many hours in the day and lets get the essentials done first or the latter is pointkess. James

« previous php.dev (#29752) next »