Hi Sean,
Sean Coates wrote:
PHP 5 uptake is also speeding up and there are a couple of areas of
the manual that are confusing. A search for "xml" or going to
php.net/xml lands you on php.net/manual/en/ref.xml.php which has no
mention of the different xml implementations available.
The best way to handle this, probably, is to add a very high level
"XML Processing in PHP" appendix and link xml there. The appendix
could then link the the various sections: DOM, libxml, SimpleXML,
ref.xml, etc.
Alternative:
Let the search handle this "ambiguous" terms and nuke this kinds of
shortcuts?
php.net/xml would give you a page with results relevant to xml, of
course extension/implementation wise.
The point Rasmus made boils probably down to "categorized manual"
http://cvs.php.net/viewcvs.cgi/phpdoc/RFC/manual.xml.in?view=markup&rev=1.19
This approach would it make dead simple, php.net/xml points to
<refgroup id="refs.xml">
This said, I don't know the status of livedocs and in which way livedocs
supersedes the "categorized manual" approach.
Friedhelm