Re: installpart
| From: | Friedhelm Betz | Date: | Fri, 30 May 2003 16:49:26 +0000 |
| Subject: | Re: installpart | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969354083@lists.php.net to get a copy of this message | ||
On Friday 30 May 2003 17:54, Philip Olson wrote:
Hi Philip
thanks for your quick reply,
>
> 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
> ...
Of course the content is not perfect ;) , it is just a split/move around of
the present installpart files, which have those a bit weird titles. The
rendering of Chapter 5. Installation on UNIX like systems is a bit strange, a
guess this is due the fact that the original file had sect1 tags for Apache
Module Quick Reference and Building, which should be probably part tags.
> 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"
hm, yes. I'll have a look, how to do this.
> 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?
No idea;-), this building section is a left over from the old install.unix.xml
file.
> I think that's all, for now :)
Thanks for your comments. As said above, this proposal should be read as a
possible solution for the new structure and of course the contents need more
polish;-)
What do you think about different parts for "Getting Started" and
"Installation" ( the diff between v1 and v2)?
Regards
Friedhelm