Date: Thu, 10 Aug 2000 00:36:22 +0100 From: Mark Ovens <marko@freebsd.org> To: Neil Blakey-Milner <nbm@mithrandr.moria.org> Cc: doc@freebsd.org Subject: Re: Re-structuring of the docs Message-ID: <20000810003622.B251@parish> In-Reply-To: <20000809201305.A30032@mithrandr.moria.org>; from nbm@mithrandr.moria.org on Wed, Aug 09, 2000 at 08:13:05PM %2B0200 References: <20000809135441.D251@parish> <20000809201305.A30032@mithrandr.moria.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, Aug 09, 2000 at 08:13:05PM +0200, Neil Blakey-Milner wrote:
> 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.
>
Hmm, I had been discussing this with Nik (a few months ago) and he
never mentioned this PR (he knows about it 'coz he responded to it).
OK, I guess I'll leave his alone then.
> > 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
--
4.4 - The number of the Beastie
________________________________________________________________
51.44°N FreeBSD - The Power To Serve http://www.freebsd.org
2.057°W My Webpage http://ukug.uk.freebsd.org/~mark
mailto:marko@freebsd.org http://www.radan.com
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000810003622.B251>