Date: Tue, 29 Oct 2002 13:29:16 -0500 From: Len Zettel <zettel@acm.org> To: doc@FreeBSD.org Subject: Don't do that! Message-ID: <3DBED37C.8060101@acm.org>
next in thread | raw e-mail | index | archive | help
There are a number of places in the Handbook
that admonish "don't do 'x'".
While this is no doubt intended to be
helpful it really doesn't furnish much
information and talks down to the reader
in what strikes me as a very demeaning
manner.
I suggest the following alternative:
"[WARNING:] Doing "x" {will | could | or
| might} make "y" happen.
This demonstrates confidence that the
reader is an adult capable of assimilating
information, asessing risks, and behaving
in a way that will best meet her needs
and wants (which the manual writer can
never, by the nature of the situation,
know).
-LenZ-
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?3DBED37C.8060101>