From owner-freebsd-bugs  Fri Feb  1  3:42:38 2002
Delivered-To: freebsd-bugs@freebsd.org
Received: from web21106.mail.yahoo.com (web21106.mail.yahoo.com [216.136.227.108])
	by hub.freebsd.org (Postfix) with SMTP id 1F9FB37B400
	for <freebsd-bugs@FreeBSD.org>; Fri,  1 Feb 2002 03:42:33 -0800 (PST)
Message-ID: <20020201114232.39894.qmail@web21106.mail.yahoo.com>
Received: from [62.254.0.4] by web21106.mail.yahoo.com via HTTP; Fri, 01 Feb 2002 03:42:32 PST
Date: Fri, 1 Feb 2002 03:42:32 -0800 (PST)
From: Hiten Pandya <hitmaster2k@yahoo.com>
Subject: Re: kern/34487: ASUS P2B-DS Problem (Close Request) 
To: Sheldon Hearn <sheldonh@starjuice.net>
Cc: freebsd-bugs@FreeBSD.org, freebsd-doc@FreeBSD.org
In-Reply-To: <95990.1012563102@axl.seasidesoftware.co.za>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: owner-freebsd-bugs@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-bugs.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-bugs>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-bugs>
X-Loop: FreeBSD.org

hi Sheldon,

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

indeed ;)

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

True, the reason I am saying about the handbook, is
because it is available in bookstores, and people feel
that their problems will be solved if they read off
from the hard copy.. well.. most :)

But FAQ is also neccessary
 
> 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".

OK, for that, I have already made a diff for the
Installation chapter of the Handbook.  The diff
is sent as a Problem Report docs/34524.  The FAQ
entry is going to be sent as a followup to the
above mentioned PR. :)

[ I've also CC'ed this copy to freebsd-doc ]

Regards,

 - Hiten Pandya
 - <hiten@uk.FreeBSD.org>

__________________________________________________
Do You Yahoo!?
Great stuff seeking new owners in Yahoo! Auctions! 
http://auctions.yahoo.com

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-bugs" in the body of the message