Date: Sun, 13 Aug 2000 21:09:42 +0000 From: Nik Clayton <nik@freebsd.org> To: Neil Blakey-Milner <nbm@mithrandr.moria.org> Cc: Mark Ovens <marko@freebsd.org>, doc@freebsd.org Subject: Re: Re-structuring of the docs Message-ID: <20000813210942.C4052@kilt.nothing-going-on.org> 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: > > 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000813210942.C4052>