From owner-freebsd-doc  Fri Feb  1 18:20:47 2002
Delivered-To: freebsd-doc@freebsd.org
Received: from lists.blarg.net (lists.blarg.net [206.124.128.17])
	by hub.freebsd.org (Postfix) with ESMTP id B37D137B41D
	for <freebsd-doc@FreeBSD.ORG>; Fri,  1 Feb 2002 18:20:43 -0800 (PST)
Received: from thig.blarg.net (thig.blarg.net [206.124.128.18])
	by lists.blarg.net (Postfix) with ESMTP
	id 2CDACBDC6; Fri,  1 Feb 2002 18:20:43 -0800 (PST)
Received: from localhost.localdomain ([206.124.139.115])
	by thig.blarg.net (8.9.3/8.9.3) with ESMTP id SAA11674;
	Fri, 1 Feb 2002 18:20:42 -0800
Received: (from jojo@localhost)
	by localhost.localdomain (8.11.6/8.11.3) id g122LJT04044;
	Fri, 1 Feb 2002 18:21:19 -0800 (PST)
	(envelope-from swear@blarg.net)
To: Andrew McKay <andy@openirc.co.uk>
Cc: freebsd-doc@FreeBSD.ORG
Subject: Re: docs/34524: [PATCH] - Add important pre-installation notice
References: <20020202005718.J61686-100000@fluoxetine.lan>
From: swear@blarg.net (Gary W. Swearingen)
Date: 01 Feb 2002 18:21:18 -0800
In-Reply-To: <20020202005718.J61686-100000@fluoxetine.lan>
Message-ID: <0k3d0kk4ip.d0k@localhost.localdomain>
Lines: 23
User-Agent: Gnus/5.0808 (Gnus v5.8.8) XEmacs/21.1 (Cuyahoga Valley)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.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-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org

Andrew McKay <andy@openirc.co.uk> writes:

> +    <note>
> +      <para>Many installation problems can be avoided or alleviated by
> +        updating the firmware on various hardware components, most notably
> +        the motherboard.  If the installation fails to work then updating
> +        the BIOS may solve the problem.  Refer to your motherboard
> +        manufacturer's website for information on BIOS revisions and upgrade
> +        instructions.</para>
> +      <para>Most manufacturers strongly advise against upgrading motherboard
> +        BIOSs unless you have a good reason for doing so.  The
> +        process <emphasis>CAN</emphasis> go wrong, causing the BIOS to be
> +        destroyed permanently.  Therefore <emphasis>DO NOT</emphasis> do
> +        this unless you believe it will solve your problem.</para>
> +    </note>

Looks good to me.  I tend to not like preachy docs, so I'd probably
leave out that last bit of advice, but it's OK.  And I'd change
"fails to work" to "fails,", but that's OK as-is too.  One more --
I'd probably change "Many" to "Some" at the beginning.  No need to
waste time on it further if you'd rather not change it or disagree.

(Is this what they call bikeshedding, or is it more-or-less welcome?)

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