Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 20 Jul 2004 16:47:08 +0100
From:      Nik Clayton <nik@freebsd.org>
To:        Marc Fonvieille <blackend@freebsd.org>
Cc:        doc@freebsd.org
Subject:   Re: Creating an Admin Handbook
Message-ID:  <20040720154707.GB64597@clan.nothing-going-on.org>
In-Reply-To: <20040720140759.GA69951@abigail.blackend.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>

next in thread | previous in thread | raw e-mail | index | archive | help

--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--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040720154707.GB64597>