Hi,
I am reporting that the restructuring part of the install section is at least prepared. It needs review from more people (ie. build the HTML version and/or review with livedocs). There might be incosistent IDs, titles, etc. If the structure reviewers find that it is OK (maybe after fixing some errors I made), we can go on with reviewing the contents.
It would be nice to look at this work from a technical perspective first (file names, organization, IDs, section titles), so we can fix that up, and then go on to fix the contents. I have done make test-ing and make test_xml also found no errors. Here is how to test:
- edit your local copy of manual.xml.in
-> uncomment the new install part
-> put the old install part and php.ini section into comments
(or otherwise IDs will clash)- run configure
- make test and make text_xml should be fine (although there are broken links in the manual with this setup due to changed IDs, but that should only be fixed, if the permanently switch to this new part)
- now either build your local HTML copy or use livedocs locally (maybe someone can even put up an online version of this somwhere)
I have not changed manual.xml.in yet, since I beleive it is only viable if we review the structure and selected IDs at least (so notes can be moved and links can be corrected within the manual).
IMPORTANT: What is gone from the Unix part?
- Linux specific instructions: only contained a note on using packages which was integrated to the general unix stuff. Most of the user notes are server specific, so should be moved to the different server docs. There are some OS specific notes, which I don't know of what to do with (move to unix general page?).
- Apache quick reference: this is not needed anymore IMHO, since we have more and more places, where a choice need to be made (CLI/CGI, PHP 4 / PHP 5, etc), so providing a single quick reference is not possible.
- section of other servers: only contained two lines of text. User notes should be moved to the general unix page (will have a lot of notes there)
BTW I beleive that we should bring back the other servers page, and we should link to instructions for servers not covered in the manual, but dealt with elsewhere. Some user notes will help in this. Then we can keep the user notes on this page. Otherwise this page is pretty useless.
If I remember correctly, everything else was taken over to this section...
IMPORTANT FOR TRANSLATORS: it is still NOT the time to start and translate this part, since possibly major content / markup changes are ahead.
Now the xml files are out for reviewers. The sooner you fix my errors, the sooner we can start reviewing the install sections, so finally can include a more accurate, better navigable and even more complete install section.
Wez, if you have the time, please look at the Windows instructions, and correct them.
Goba
