Hello all,
Since PHP 5 came out a lot of new extensions with classes and predefined
constants have appeared. As a result of all this, the ref pages are
getting huge. For instance, take the ref page for the filter extension,
it's one of the smaller ones, but even on this one you've got a huge
page with a large load of content which most people just wanting a
casual look at the extension couldn't care a rats' ass about.
What I would like to see again is just that small list of functions
contained in that one extension and a separate page for all those
constants, another page for configuration directives, etc. Compare it to
eg. the Perl Regular Expressions section (not the look of the ref
section since that's bloated too IMO): it has separate pages for Pattern
Modifiers and Pattern Syntax.
Now, it might be just me, but I think we should think about what the
ref-page is actually for. Is it there (as I believe it should be) to
show a summary of what that extension IS and provide links to other
(sub)sections which explain it in detail if a user wished to do so. Or
is it there to dump all documentation that does not fit anywhere else
(like it seems to be used now) ?
Hoping this might spark a bit of a discussion :)
- Tul
