Hi Goba,

first a big thank you for your work!

>
> 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:

[...]

ASAP I will do some tests.

> 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.

Ack.

>   - 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.

+ 1 for bringing back the other servers page.

> 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.

As the german translation is near dead, no fear from that translation
front; -)

> 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.

I will take a look asap.

Btw. the user notes:
The best thing IMHO would be, if we could clean up the notes before moving 
them around, that would be great. Maybe later in the evening I'll find the 
time to do some cleanup.

Friedhelm

Reply via email to