Hi all

We have a new development branch in town, REF_STRUCT_DEV.
The goal of this branch is to create a new reference navigation
structure and new OO doc skeleton.

I've committed initial changes to the manual.xml.in,
scripts/file-entities.php.in, XMLreader and the Reflection extension
using a new reference structure and OO doc model.

As a result of this change we have a lot of room for whole bunch of cool stuff.
This essentially screams for more documentation writers to participate
in the project as we now have a lot of opportunities for writers.
To name a few:
 - Possibility to add "basic usage of this extension" pages (PDO/SCA/SDO....)
 - Possibility to add FAQ/tutorials for each extension
 - Possibility to add articles for each extension
 - Possibility to cut long and complex documents (header(), mail()...)
into simple manual pages linking to "further examples and howtos"
within the extension.


I'll be working more on this over the weekend and will change the
cronjob on http://docs.php.net to build (from this branch) every
6hours so you can see the results of all this.

This is a fairly major change (yet relatively simple one) so I would
like to ask all of you to throw in your two cents, after browsing
through docs.php.net (the XMLReader and (the new) Reflection docs
especially), about all this.

Don't be afraid to continue committing.
This branch does not affect your current checkouts so you can continue
to commit as you've always done. I can take care of all the merging -
as long as you don't commit major changes to the OO documentation :)


Note to translators: You should *NOT* sync your translations to the new branch.


-Hannes

Reply via email to