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
> 




-- 
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php

Reply via email to