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
