Date: Sun, 6 Oct 1996 14:52:28 -0500 (EST) From: John Fieber <jfieber@indiana.edu> To: Joerg Wunsch <joerg_wunsch@uriah.heep.sax.de> Cc: "Jordan K. Hubbard" <jkh@freefall.freebsd.org>, CVS-committers@freefall.freebsd.org, cvs-all@freefall.freebsd.org, cvs-share@freefall.freebsd.org Subject: Re: cvs commit: src/share/doc/FAQ FAQ.sgml Message-ID: <Pine.BSI.3.95.961006144017.7499B-100000@fallout.campusview.indiana.edu> In-Reply-To: <199610061422.QAA08205@uriah.heep.sax.de>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sun, 6 Oct 1996, J Wunsch wrote: > Who guarantees then that the handbook will be maintained on a more > regular basis? Nobody. :( As I've said before (probably in the doc list), I see the ideal FAQ as a dynamic document addressing relatively narrow topics with quick well defined answers. It should be highly responsive to the *current* state of FreeBSD, documenting quirks in particular releases, common pitfalls and the like. The handbook, on the other hand, should be for more in depth topics that cannot adequately be addressed in a 2-5 paragraph FAQ answer. Generally the topics are a bit more stable than FAQ topics, for example the Printing chapter. The FAQ addresses "I've got this little problem" or "Will X work?". The handbook addresses "I want to learn all about Y". Ultimately putting FAQ type material in the handbook would be counterproductive. -john == jfieber@indiana.edu =========================================== == http://fallout.campusview.indiana.edu/~jfieber ================
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.BSI.3.95.961006144017.7499B-100000>