Re: installpart

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

« previous php.doc (#969354083) next »