Re: cvs: phpdoc /en/appendices phpdevel.xml
| From: | Gabor Hojtsy | Date: | Sat, 01 Jun 2002 12:22:54 +0000 |
| Subject: | Re: cvs: phpdoc /en/appendices phpdevel.xml | ||
| References: | 1 2 3 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969346078@lists.php.net to get a copy of this message | ||
> if you want to make one section with all the developer-info in it, I'm
> fully with you, and would go one step further, to structure like
> - developing PHP
> - Building PHP from source (from Win-install-section, it's just
> confusing newbies which just downloaded the bin-distri)
> - extending PHP 3
> - extending PHP 4
> more to come (e.g. Zendapi 2)?
>
> But PLEASE consider and agree on it completely before you make the the
> changes to prevent the current chaos we have now.
Very nice idea ;) As I tried to propagte the idea of having a separate
<book> (!) for developing PHP, and providing it in a separate download,
I fully agree on at least consolidating these sections all in one place
in the manual. BTW I still think it would be better to open a new book
on developing PHP, because this part is **rarely** used by PHP
programmers. It would make searches faster, download size smaller,
manual generation faster + simpler, etc.
> We are still in the "consolidation-phase" of all the last changes in the
> past e.g. the install split still isn't solved, this all makes confusion
> to the writers/translators (which slows them down or even prevents them
> from working) on one hand, slows down builds, and makes the files for
> the build-process hard to read.
Fully agree with you.
Goba