Date: Sun, 22 Sep 1996 16:50:19 -0700 From: "Jordan K. Hubbard" <jkh@time.cdrom.com> To: "Eric J. Schwertfeger" <ejs@bfd.com> Cc: chat@freebsd.org Subject: Re: Not really a question, but a favor. Message-ID: <6399.843436219@time.cdrom.com> In-Reply-To: Your message of "Sun, 22 Sep 1996 15:32:08 PDT." <Pine.BSF.3.95.960922151537.18802A-100000@harlie>
next in thread | previous in thread | raw e-mail | index | archive | help
> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?6399.843436219>