Hi,
| to have a solution for that ugly file structure introduced in install
| files, and find final places for install files.
Yes we really need a solution which will stand the test of time.
It will cause me a big headache to keep up with the updates in
install chapter if the other languages (including "hu") cannot/
don't follow the recent english file structure.
There were a little discussion how the install.xml can be split
and distributed reasonably between existing dirs and with creating
new ones. But no decision yet.
Some months ago it could be acceptable that translators would need
to do their job twice if they jumped to the new english install files
immediately - not waiting for a fully deliberated configuration.
Now time goes by, new stable Apache has been released, PHP 4.2.0
comes soon. More and more people will be eager to read the most
recent installation steps to make work together their favourite
dev tools.
IMO, translators should translate these new instructions...
| First of all 90% of config.xml and install.configure.*.xml files
| can be distributed into extension documentation files. The question
| is who has the time to do this, and how to do this.
| For now, we have mysql/reference.xml [and maybe some others]
| with the ini info moved into the extension reference. IMHO it would
| be the best to have a configure.xml and an ini.xml file in every
| reference dir with the corresponding configure and ini stuff.
| These files can of course contain the same [or similar] structure
| used in mysql/reference.xml
This can be aa very good starting point. Each function reference
should contain two additional files:
ini.xml -- installation (compile time) instruction
config.xml -- everything related to php.ini (maybe?)
| So then intro.xml install.*.xml and security.xml will be left
| in chapters/. We'll we previously agreed (as I remember ;),
| that chapters is a really odd name for this. And we also agreed
| on a new directory named install for general, and server related
| installation information.
|
| So intro.xml and security.xml is left in chapters... IMHO security
| is a kind of appendix, though it is much more important than to be
| an appendix... Intro needs some more info, the integration of
Yes, security is much more. I'm afraid that users tend to disregard it
by putting it into an appendix (to the end of the manual).
BTW, I have an other problem with its current location. I think a newbie
must read a lot ahead -- at least to the language section --, and return
back to these security manners to really understand what it's about.
Can security.xml be put into "features" directory or distribute its
content in other .xml's? (just not an appendix :)
