From owner-freebsd-doc Wed Aug 9 11:13:26 2000 Delivered-To: freebsd-doc@freebsd.org Received: from ns1.sunesi.net (ns1.sunesi.net [196.15.192.194]) by hub.freebsd.org (Postfix) with ESMTP id 7CABC37BED9; Wed, 9 Aug 2000 11:13:09 -0700 (PDT) (envelope-from nbm@sunesi.net) Received: from nbm by ns1.sunesi.net with local (Exim 3.03 #1) id 13MaLh-0007pR-00; Wed, 09 Aug 2000 20:13:05 +0200 Date: Wed, 9 Aug 2000 20:13:05 +0200 From: Neil Blakey-Milner To: Mark Ovens Cc: doc@freebsd.org Subject: Re: Re-structuring of the docs Message-ID: <20000809201305.A30032@mithrandr.moria.org> References: <20000809135441.D251@parish> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <20000809135441.D251@parish>; from marko@freebsd.org on Wed, Aug 09, 2000 at 01:54:41PM +0100 Organization: Sunesi Clinical Systems X-Operating-System: FreeBSD 3.3-RELEASE i386 X-URL: http://rucus.ru.ac.za/~nbm/ Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed 2000-08-09 (13:54), Mark Ovens wrote: > I had also started working on producing a master index[1] for the > docs PR 14165. > The FDP Primer and the PPP Primer are under books/ in the cvs tree yet > are installed under tutorials. Looking at both docs they are > sufficiently large and well structured enough to be called handbooks > in their own right, like the Porters Handbook. "Primers" are things which cover a specific area at depth. "Handbooks" cover largish areas without much depth. > Also it would seem appropriate to merge the tutorial on setting up and > using a firewall with a PPP connection into the PPP {Primer,Handbook}. I wouldn't think so. I'd prefer to see a "Network [Administrator] Handbook" to cover that. That tutorial specifically doesn't talk about ppp issues. I do propose that we set up the docs in the same tree as they're installed on home systems on the web, so (for one) links work. Neil -- Neil Blakey-Milner Sunesi Clinical Systems nbm@mithrandr.moria.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message