||*()*|| Hi, Gabor. >> I'd like also: >> - to include HOWTO into docs; GH> What? Do you mean that our end users are interested in the HOWTO? Why? Well, at least to make everything available in one place. If there is a section for PHP extension developers why not to have one for manual writers/translators? For those who always online it isn't necessary, but for other people who use downloadable format this can be become interesting.
>> - merge streams section with ZendAPI; GH> Someone needs to find time to look into the ZendAPI stuff deeper, and GH> come up with a suggestion on tags we can use to integrate thte ZendAPI GH> docs into the manual, and then to merge that part with the streams GH> development stuff. It was the first thought I came to - merge streams section, but there is another problem. Indexing. There was a bug rep about user notes clutter search results and what if there is also a developers notes? Weird. Of course when it is in PHP manual it is rather interesting to read and I've almost written a dummy plugin just because of curiousity, but for most users this is too much. After higher mathematics I didn't believe that there can be things to confuse me, but m4 + english have done that. =) Therefore.. >> - release a separate PHP3 manual; GH> Now? I wonder how you imagine that. It is a tremendous amount of human GH> work to tag the different parts of the manual now for PHP 3, as PHP 3, 4 GH> and 5 content is intermixed. What if we fetch a CVS verson of manual before PHP 4.3.0 version for example or when a latest PHP3 patches were commited to repository? Or when the support for PHP3 had stopped. Remove all functions, what were not present in PHP3 and leave it "as is". Well, maybe reviewing some pages to mark what features are specific for "upcoming" PHP4. =) >> - think about separate ZendAPI and PHPAPI manual; GH> What do you mean with PHPAPI here? Well, you are right. It's a mistake. PHP Manual. Merge Streams and PHPAPI sections into ZendAPI and release a separate developers manual. So PHP users can search only PHP manual and developers can use their own. >> - ability to link ZendAPI CHM like user notes CHM. GH> Which is only needed, if we separate the ZendAPI builds. Yep. t --
