From owner-freebsd-chat  Sun Sep 22 16:50:26 1996
Return-Path: owner-chat
Received: (from root@localhost)
          by freefall.freebsd.org (8.7.5/8.7.3) id QAA01089
          for chat-outgoing; Sun, 22 Sep 1996 16:50:26 -0700 (PDT)
Received: from time.cdrom.com (time.cdrom.com [204.216.27.226])
          by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id QAA01064
          for <chat@freebsd.org>; Sun, 22 Sep 1996 16:50:23 -0700 (PDT)
Received: from time.cdrom.com (localhost [127.0.0.1]) by time.cdrom.com (8.7.6/8.6.9) with ESMTP id QAA06401; Sun, 22 Sep 1996 16:50:19 -0700 (PDT)
To: "Eric J. Schwertfeger" <ejs@bfd.com>
cc: chat@freebsd.org
Subject: Re: Not really a question, but a favor. 
In-reply-to: Your message of "Sun, 22 Sep 1996 15:32:08 PDT."
             <Pine.BSF.3.95.960922151537.18802A-100000@harlie> 
Date: Sun, 22 Sep 1996 16:50:19 -0700
Message-ID: <6399.843436219@time.cdrom.com>
From: "Jordan K. Hubbard" <jkh@time.cdrom.com>
Sender: owner-chat@freebsd.org
X-Loop: FreeBSD.org
Precedence: bulk

> I'm trying to give back to the community that has made my job a lot
> easier.  I'm trying to set up a set of "guide" pages for setting up a web
> server using FreeBSD and Apache, including any areas that the documents
> didn't make things clear to me.  Check out
> 
> 	http://pandora.bfd.com/guides/guides.html 

They look pretty good!  A few points of feedback, however:

1. You're referring to split handbook sections directly, e.g.:
	http://www.freebsd.org/handbook/handbook101.html
   and this will break if something is added/deleted in the
   handbook and the number of pieces changes.  You should refer
   to sections by symbolic tag, e.g.:
	http://www.freebsd.org./handbook/hw.html

   If you look through the SGML sources in /usr/src/share/doc/handbook,
   you'll see <label> tags which denote the sections which can be referred to
   directly in this fasthion.

2. Have you considred submitting this as a tutorial to the FreeBSD
   Documentation Project?  Such would get your text bundled with the
   standard doc system and be far more accessible to FreeBSD users
   everywhere.

3. It is incorrect to say that Linux is "POSIX based."  What it is
   is widely POSIX _compliant_, just as FreeBSD can claim to be in several
   areas (but not all or in as many as Linux).  Linux is not based on
   any existing technology, to my knowledge, and POSIX is a standard,
   not a code base.

4. "Linux is constantly changing, and I find that the man pages, which ..."
   Looks like the writer fell over in midsentence somewhere. :-)


You might want to pursue this in the doc@freebsd.org mailing list.

Thanks!

						Jordan