Re: "waldschrotts guide to nifty references" - manual page draft, version 0.9b

Stanislav Malyshev writes: > AL>> We should place things like ref-counting and so on in the manual too, > AL>> perhaps in an appendix. > > What for? Refcounting is not visible from userspace in no way, why do you > need it in the manual? > > AL>> My thoughts on the situation currently are "We´ve a good > AL>> product, but no one knows, because few is documented at one > AL>> centralized place" > > Calling existing PHP manual "few" is a huge underestimate, IMO. > But let's not bring there everything and the kitchen sink. Manual should > be just reference, not all-about-the-subject tutorial. > > -- > Stanislav Malyshev stas@zend.com > +972-3-6139665 ext.106 I agree--there are lots of things about the language that don't really need to be explained right in the manual itself. Although an appendix may not be a bad place for this sort of thing, along with the extension programming notes and other things that 99.7% of users won't ever need to know. :) -- +----------------------------------------------------------------+ |Torben Wilson <torben@php.net> Netmill iTech| |http://www.coastnet.com/~torben http://www.netmill.fi| |Ph: 1 250 383-9735 torben@netmill.fi| +----------------------------------------------------------------+