For Programmers: Free Programming Magazines  


Home > Archive > PHP Documentation > June 2004 > install part: iplanet server blues









You are viewing an archived Text-only version of the thread. To view this thread in it's original format and/or if you want to reply to this thread please [click here]

 

Author install part: iplanet server blues
Gabor Hojtsy

2004-06-04, 8:56 pm

Hi,

So far the "split by os then by server" method is quite fine, apache 2
has some notes which need to be on all ocassions of apache 2, but they
are not really huge, so it is not a real problem.

However the iPlanet server docs has three sections which are meant to be
cross-platform, so it is a good question on where should we put them.

- Either we pick one platform and put these docs there, and link it in
from the other one. This might not be good, since some docs have
small differences based on OS.

- Or we create snippet xml files out of the sections and insert them
to both of the docs (Windows and Solaris). This might not be good,
since some docs have small differences based on OS.

- Or we put the somewhat different text at both places in the XML,
only having OS relevant notes at both places. This makes the best
output for our readers, but it is a bit harder to maintain and
translate.

See: http://php.net/install.netscape-enterprise

Your choice? Number four?

Goba
Mehdi Achour

2004-06-05, 8:55 am

Hi Gabor,

Gabor Hojtsy wrote:
> Hi,
>
> So far the "split by os then by server" method is quite fine, apache 2
> has some notes which need to be on all ocassions of apache 2, but they
> are not really huge, so it is not a real problem.
>
> However the iPlanet server docs has three sections which are meant to be
> cross-platform, so it is a good question on where should we put them.
>
> - Either we pick one platform and put these docs there, and link it in
> from the other one. This might not be good, since some docs have
> small differences based on OS.
>
> - Or we create snippet xml files out of the sections and insert them
> to both of the docs (Windows and Solaris). This might not be good,
> since some docs have small differences based on OS.
>
> - Or we put the somewhat different text at both places in the XML,
> only having OS relevant notes at both places. This makes the best
> output for our readers, but it is a bit harder to maintain and
> translate.
>
> See: http://php.net/install.netscape-enterprise
>
> Your choice? Number four?


I would choose 3. I don't think you should worry more about the
translators than our readers. I also would like to thank you for your
great work so far, thank you !

didou
Sponsored Links







Also available: Server administration forum archive | Web Design forum archive | Software forum archive | Hardware reviews archive

Copyright 2008 codecomments.com