From owner-freebsd-doc Sun Aug 13 14:25:54 2000 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id DDB3537B73F; Sun, 13 Aug 2000 14:25:48 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id VAA04087; Sun, 13 Aug 2000 21:09:42 GMT (envelope-from nik) Date: Sun, 13 Aug 2000 21:09:42 +0000 From: Nik Clayton To: Neil Blakey-Milner Cc: Mark Ovens , doc@freebsd.org Subject: Re: Re-structuring of the docs Message-ID: <20000813210942.C4052@kilt.nothing-going-on.org> References: <20000809135441.D251@parish> <20000809201305.A30032@mithrandr.moria.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <20000809201305.A30032@mithrandr.moria.org>; from nbm@mithrandr.moria.org on Wed, Aug 09, 2000 at 08:13:05PM +0200 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Aug 09, 2000 at 08:13:05PM +0200, Neil Blakey-Milner wrote: > > 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. Contra-example: porters-handbook. IMHO, Mark's right on this. However, directory renames are relatively expensive operations in CVS. Both the PPP and FDP primer's started life as much smaller documents, and I certainly didn't expect the FDP primer to become as large as it has done. The location in the website is historical accident, and the resistance to moving them is mostly because doubtless there are links to them out there, and we don't want to invalidate those links. There are procedures we can do to mitigate this (for example, by checking the error logs for pages after we move them, and pro-actively contacting the people that host the pages that link to the moved files) but that's effort that I haven't got the time to expend. If someone's volunteering to do this sort of thing then more power to them. The other alternative is just to break some of the referring sites, and tolerating the (assumed) additional messages to -questions or -doc. I'm agnostic on this. Broken links are a part of the web. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message