Skip site navigation (1)Skip section navigation (2)
Date:      01 Feb 2002 18:21:18 -0800
From:      swear@blarg.net (Gary W. Swearingen)
To:        Andrew McKay <andy@openirc.co.uk>
Cc:        freebsd-doc@FreeBSD.ORG
Subject:   Re: docs/34524: [PATCH] - Add important pre-installation notice
Message-ID:  <0k3d0kk4ip.d0k@localhost.localdomain>
In-Reply-To: <20020202005718.J61686-100000@fluoxetine.lan>
References:  <20020202005718.J61686-100000@fluoxetine.lan>

next in thread | previous in thread | raw e-mail | index | archive | help
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




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