Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 6 Dec 2001 23:24:35 -0500
From:      Bosko Milekic <bmilekic@technokratis.com>
To:        Mike Silbersack <silby@silby.com>
Cc:        Robert Watson <rwatson@FreeBSD.org>, Matthew Dillon <dillon@apollo.backplane.com>, 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:  <20011206232435.A39016@technokratis.com>
In-Reply-To: <Pine.BSF.4.30.0112062230070.16311-100000@niwun.pair.com>; from silby@silby.com on Thu, Dec 06, 2001 at 10:34:49PM -0500
References:  <Pine.NEB.3.96L.1011206214123.33559D-100000@fledge.watson.org> <Pine.BSF.4.30.0112062230070.16311-100000@niwun.pair.com>

next in thread | previous in thread | raw e-mail | index | archive | help

On Thu, Dec 06, 2001 at 10:34:49PM -0500, Mike Silbersack wrote:
> On Thu, 6 Dec 2001, Robert Watson wrote:
> 
> > "FreeBSD 4.3 flirted with turning off IDE write caching" doesn't necessary
> > come across more clearly than "In FreeBSD 4.3, we experimented with
> > disabling IDE write caching by default."  Optionally adding "to address
> > legitimate concerns with data integrity".  It's still written in an
> > informal tone (use of "we", et al) but it may be more clear.  It not only
> > makes us look more professional, but it also makes it seems like we don't
> > consider our system a joke: we didn't flirt, we weighed the choices,
> > decided on something, and later changed our minds based on available
> > evidence and user needs.
> 
> Yeesh, we're getting quite uptight here.  Matt's word choice was, well,
> Matt's word choice because he wrote the page.  While some of it may be
> funny, none of it is offensive.  Let's quit the nitpicking and leave it
> alone unless there are technical details to be changed.  I'm sure the rest
> of us have better things to do.

I don't get it. What's the big deal with nitpicking on something like
this? If it sounds unprofessional, it certainly *should* be changed;
this is a man page we're talking about, not a comment!

It seems that the actual `nitpicking' is occuring in response to the
commit, not in the commit itself. :-)

In summary, we shouldn't be opposed to seeing other people make man
pages sound more professional; the only time I would be opposed and
comment on it is if someone asked me to stop whatever technical thing
I'm working on so that I can "turn my man page text more professional,"
which clearly isn't the case here. The case here is that of someone else
coming in and fixing it *for* me. How can anyone complain about that?

> Mike "Silby" Silbersack

Cheerio,
-- 
 Bosko Milekic
 bmilekic@technokratis.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?20011206232435.A39016>