From owner-freebsd-doc@FreeBSD.ORG Tue Jul 20 15:47:19 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3451E16A4CE; Tue, 20 Jul 2004 15:47:19 +0000 (GMT) Received: from jc.ngo.org.uk (jc.ngo.org.uk [69.55.225.33]) by mx1.FreeBSD.org (Postfix) with ESMTP id E7C9E43D46; Tue, 20 Jul 2004 15:47:17 +0000 (GMT) (envelope-from nik@crf-consulting.co.uk) Received: from crf-consulting.co.uk (82-44-220-218.cable.ubr10.haye.blueyonder.co.uk [82.44.220.218]) by jc.ngo.org.uk (8.12.11/8.12.11) with ESMTP id i6KFlA8i054981; Tue, 20 Jul 2004 08:47:11 -0700 (PDT) (envelope-from nik@crf-consulting.co.uk) Received: from clan.nothing-going-on.org (clan.nothing-going-on.org [192.168.1.20])i6KFl9rK041443; Tue, 20 Jul 2004 16:47:09 +0100 (BST) (envelope-from nik@catkin) Received: from clan.nothing-going-on.org (localhost [127.0.0.1]) i6KFl9cN065778; Tue, 20 Jul 2004 16:47:09 +0100 (BST) (envelope-from nik@clan.nothing-going-on.org) Received: (from nik@localhost)i6KFl9A1065777; Tue, 20 Jul 2004 16:47:09 +0100 (BST) (envelope-from nik) Date: Tue, 20 Jul 2004 16:47:08 +0100 From: Nik Clayton To: Marc Fonvieille Message-ID: <20040720154707.GB64597@clan.nothing-going-on.org> References: <20040719100354.GA90972@hub.freebsd.org> <20040720103432.GA64597@clan.nothing-going-on.org> <20040720104501.GB5405@hub.freebsd.org> <20040720124337.GA8096@electra.cse.Buffalo.EDU> <20040720140759.GA69951@abigail.blackend.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="bCsyhTFzCvuiizWE" Content-Disposition: inline In-Reply-To: <20040720140759.GA69951@abigail.blackend.org> User-Agent: Mutt/1.4.2.1i Organization: FreeBSD Project cc: Nik Clayton cc: Ken Smith cc: doc@freebsd.org Subject: Re: Creating an Admin Handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 20 Jul 2004 15:47:19 -0000 --bCsyhTFzCvuiizWE Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Jul 20, 2004 at 04:07:59PM +0200, Marc Fonvieille wrote: > of Handbook and FAQ. > Why FAQ is not really used/read? It's difficult to answer to that > question but I assume cause it's less "famous" and cause the human being > is lazy, it's an effort to go read the Handbook, so switching to the FAQ > is too much :)=20 I've said it before, I'll say it again -- the FAQ needs to die. =20 In the same way that each chapter has a "Synopsis", each chapter should have a FAQ section, at the end of the chapter, containing relevant content scooped out from the existing FAQ. Production of a master-FAQ, containing all the FAQ content from the Handbook(s) would then be possible. I had grand plans for this a few years ago. Then, inexplicably, I went and got a life, and free time plummeted. N --=20 FreeBSD: The Power to Serve http://www.freebsd.org/ (__) FreeBSD Documentation Project http://www.freebsd.org/docproj/ \\\'',) \/ \= ^ --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- .\._/= _) --bCsyhTFzCvuiizWE Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA/T57k6gHZCw343URApe4AJ42UB5b45CoMJ+9+GBz9EJsgxZ/8QCfUtrh kYRWGWxMZ5Ez4jfwUKUQk94= =hb0d -----END PGP SIGNATURE----- --bCsyhTFzCvuiizWE--