Re: installpart
| From: | Philip Olson | Date: | Fri, 30 May 2003 15:54:02 +0000 |
| Subject: | Re: installpart | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969354080@lists.php.net to get a copy of this message | ||
Hello Friedhelm-
I like the idea of this separation of Windows/*nix but do
have a few concerns, in looking at the *nix section:
a) Apache Module Quick Reference
This is a little confusing and should be moved (or deleted)
into the Apache1 section.
b) Building
What is this section for? It currently just mentions CGI,
what will this be?
c) All the titles have Unix in them, why? How about:
Linux
HP-UX
...
People already know they are related to Unix as they are in
the "Unix Like" section. And besides, let's not give SCO
any more ammo! :)
d) Navigation
It's a little difficult to navigate. The servers.unix.xml
TOC should be listed in several places. For example, when
I click on "Unix/Linux installs", I expect to see this list
of web servers. This might not be appropriate for some but
it took me awhile to figure out where to find web server
documentation. In the very least, the web server list
should be more like "List of Web Servers" as opposed to
"Servers on Unix like Systems"
e) SAPI - CGI vs static vs module
There needs to be more distinction between CGI, static,
and module versions. We toss the word SAPI around in
various places yet don't document it very well in the
installation docs. Or maybe this is what the building
section is for?
I think that's all, for now :)
Regards,
Philip
On Fri, 30 May 2003, Friedhelm Betz wrote:
> Hi,
>
> looooong time ago, I promised to have a look at the installpart files under
> chapters (see also RFC/installpart) and how this files can be reorganized.
> The results can be viewed here:
> www.holliwell.de/installpart/
>
> Version 1 (v1): no separate part for installation
> Version 2 (v2): separate part for installation
> sources.tar.bz2 holds the files in question and the modified manual.xml.in
>
> Some small (but important) pieces of information are not included yet, but
> take this as some sort of "proof of concept".
>
> Also note, that the choosen xml tags from docbook might not be optimal
> (missused? some refentry/refsect tags for the servers).
>
> Comments/suggestions?
>
> Friedhelm
>
> --
> PHP Documentation Mailing List (http://www.php.net/)
> To unsubscribe, visit: http://www.php.net/unsub.php
>