On Thu, 2008-04-24 at 14:17 -0700, Philip Olson wrote: > On 22 Apr 2008, at 13:26, Hannes Magnusson wrote: > > Hei! > > > >> The index > >> (http://docs.php.net/manual/en/indexes.php) should be found a bit > >> easier, > >> IMO, it's not just one appendice.. :) > > > > Move it to the "PHP Manual" listing at the top maybe? > > One problem is this isn't an index of the PHP manual. It's based on > php-src/ and part of pecl/ both of which contain a decent amount of > undocumented and strange information. And it only contains functions. > So until we discuss what we want the index to be, I move we leave it > where it's at because it's not worth promoting in its current state.
Gotta agree, don't promote crap please. :) > > I think the redirecting to ext-intro page for php.net/extname may have > > been a mistake, it probably should be the book TOC page (i.e > > www.php.net/book.dom rather than www.php.net/intro.dom) like it was > > originally. > > I agree book.foo should be the first. Yup, definately. One thing about these manual pages, example shows it the best: http://docs.php.net/manual/en/zlib.setup.php Is it really necessary to split this to 3 different pages..? (Installation, Runtime Configuration, Resources types) And btw. That "Runtime" there is VERY misleading. Not every ini option is modifiable during runtime. Just make it "Configuration options" or something as vague as that. :) > I also like them consistent however we can make a few adjustments like > be sure every topic is in the TOC (like Requirements). And one option > that I've not fully thought about but will say anyways is adding a > page to each section that lists everything. So a user clicks on "I > want everything please" and sees config/install/constants/function > list/etc... this may be crazy but brain storming often is. Even more pages? Everything right now, yes please. That's not a crazy idea at all, IMO. --Jani
