From owner-freebsd-bugs Fri Feb 1 3:29:12 2002 Delivered-To: freebsd-bugs@freebsd.org Received: from axl.seasidesoftware.co.za (axl.seasidesoftware.co.za [196.31.7.201]) by hub.freebsd.org (Postfix) with ESMTP id 9972737B402 for ; Fri, 1 Feb 2002 03:28:51 -0800 (PST) Received: from sheldonh (helo=axl.seasidesoftware.co.za) by axl.seasidesoftware.co.za with local-esmtp (Exim 3.33 #1) id 16Wbuw-000OyF-00; Fri, 01 Feb 2002 13:31:42 +0200 From: Sheldon Hearn To: Hiten Pandya Cc: freebsd-bugs@FreeBSD.org Subject: Re: kern/34487: ASUS P2B-DS Problem (Close Request) In-reply-to: Your message of "Fri, 01 Feb 2002 03:22:00 PST." <20020201112200.33875.qmail@web21106.mail.yahoo.com> Date: Fri, 01 Feb 2002 13:31:42 +0200 Message-ID: <95990.1012563102@axl.seasidesoftware.co.za> Sender: owner-freebsd-bugs@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On Fri, 01 Feb 2002 03:22:00 PST, Hiten Pandya wrote: > Hmm, It would fit better in the FAQ, but I h've seen > people who resort to the Handbook when they encounter > installation or other problems. Ah, then perhaps that's another issue to be addressed. I think the Handbook should be the canonical resource that offers, for any given issue, the information most folks are going to need. Cases like the one in this PR, where a common but silly mistake or known-flakey hardware cause problems, should be documented in the FAQ. Sections of the Handbook that have handed over documentation of such cases to the FAQ, should refer to the FAQ. That's how I see it. So I think this particular case should be documented in the Troubleshooting or Installation section of the FAQ, and the Installation section of the Handbook should refer to the FAQ for "more information on common problems encountered during installation". I'm not a -doc god, so it'd probably be worth checking that this world view is congruent with the direction the -doc project is heading in. :-) Ciao, Sheldon. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-bugs" in the body of the message