Date: Thu, 6 Dec 2001 16:40:19 -0800 (PST) From: Matthew Dillon <dillon@apollo.backplane.com> To: Robert Watson <rwatson@FreeBSD.ORG> Cc: Chad David <davidc@acns.ab.ca>, Luigi Rizzo <rizzo@aciri.org>, cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG Subject: Re: cvs commit: src/share/man/man7 tuning.7 Message-ID: <200112070040.fB70eJi59420@apollo.backplane.com> References: <Pine.NEB.3.96L.1011206174402.21187Q-100000@fledge.watson.org>
next in thread | previous in thread | raw e-mail | index | archive | help
:> Another question was if we wanted to maintain Matt's informal tone?
:> Some terms like "network suds" give the manual a more playful feeling
:> which I tried not to kill (although I did change a lot of 'I's to
:> 'we's).
:
:I cleaned up a little of that in my recent commits, and I suspect
:continuing to move gradually in the direction of formalism might be a good
:thing. But maybe I'm old and dusty. One of the concerns I did have was
:about the "currency" of the information: for example, the manpage advises
:the reader not to use IDE tagged stuff. It should probably qualify such
:statements with "at the time this document was written". These statements
:have a tendency to get old fast, and not get updated for long periods of
:time.
:
:Robert N M Watson FreeBSD Core Team, TrustedBSD Project
:robert@fledge.watson.org NAI Labs, Safeport Network Services
I really doubt that IDE tags can be both stable AND in wide-use
at the same time. Not for at least another, oh, 10 years.
Kinda like IDE in general :-( Always a moving target.
So leave it in please.
In regards to 'network suds'... some formalism is good, but don't
overdo it. There's certainly a lot of organizational work that
could be done but please don't go replacing words because they
sound 'too informal'. The Tuning document attempts to impart
a huge amount of information and if you don't inject a little
levity into it the users we are targeting with the document
will not be able to understand it, or will give up trying
to understand it after the first few paragraphs. Remember
our audience.
-Matt
Matthew Dillon
<dillon@backplane.com>
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200112070040.fB70eJi59420>