From owner-cvs-all Thu Dec 6 16:40:25 2001 Delivered-To: cvs-all@freebsd.org Received: from apollo.backplane.com (apollo.backplane.com [216.240.41.2]) by hub.freebsd.org (Postfix) with ESMTP id 370BE37B416; Thu, 6 Dec 2001 16:40:19 -0800 (PST) Received: (from dillon@localhost) by apollo.backplane.com (8.11.6/8.9.1) id fB70eJi59420; Thu, 6 Dec 2001 16:40:19 -0800 (PST) (envelope-from dillon) Date: Thu, 6 Dec 2001 16:40:19 -0800 (PST) From: Matthew Dillon Message-Id: <200112070040.fB70eJi59420@apollo.backplane.com> To: Robert Watson Cc: Chad David , Luigi Rizzo , cvs-committers@FreeBSD.ORG, cvs-all@FreeBSD.ORG Subject: Re: cvs commit: src/share/man/man7 tuning.7 References: Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG :> 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 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message