On Oct 1, 2007, at 9:27 AM, Hannes Magnusson wrote:

On 9/28/07, Hannes Magnusson <[EMAIL PROTECTED]> wrote:
cronjob on http://docs.php.net to build (from this branch) every

This is no longer true.
docs.php.net is now running the 'official' HEAD branch as it will be
used under the phd RC testing as an official mirror.

In the meantime, thanks to Sean, builds from this branch are available
at http://livedocs.phpdoc.info/manual/en/

It goes without saying that this is awesome and a great step for the PHP manual. The dream and reality of allowing an extension specific faq, tutorial, and the like, by using set/book is most excellent.

Regarding basic extension navigation, like from here:

  http://livedocs.phpdoc.info/manual/en/funcref.php

It's sometimes difficult to find an extension. Right now this uses information (status, membership, and state) that is currently defined in each reference.xml and displayed here:

  http://php.net/extensions

This is good but because it's difficult to categories all of these, and because one day we will have over 1000 extensions (god bless PECL!), we'll need to offer an alternative means or three for finding these extensions. One route (current, non-dev) is to offer users a view of them alphabetically. Another is to focus on our search functionality. Basically we need to brain storm on this because I'm afraid it's too difficult to find an extension and the problem will only get worse. Perhaps use the categorized approach as current, and offer (link to) an alphabetized version in the appendix. But maybe someone will come up with something more innovative... :)

And on a sidenote, ref.http is missing from manual.xml.in (it should be under 'Affecting PHP's Behaviour') but maybe it's not ready? Just wondering.

And for good measure, one user created the following awhile back:

  http://www.myphpdocs.com/


Regards,
Philip

Reply via email to