Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 20 Mar 2001 13:34:49 -0500
From:      Jim Mock <mij@osdn.com>
To:        richard childers <fscked@pacbell.net>
Cc:        Neil Blakey-Milner <nbm@mithrandr.moria.org>, Doug Young <dougy@bryden.apana.org.au>, Duke Normandin <01031149@3web.net>, David Johnson <djohnson@acuson.com>, Mike Meyer <mwm@mired.org>, freebsd-questions@FreeBSD.ORG
Subject:   Re: documentation issues generally
Message-ID:  <20010320133449.B7004@guinness.osdn.com>
In-Reply-To: <3AB79688.B8113E0C@pacbell.net>; from fscked@pacbell.net on Tue, Mar 20, 2001 at 09:42:33AM -0800
References:  <046701c0ab3c$c4a66300$847e03cb@apana.org.au> <3AB22989.5B28111C@pacbell.net> <20010319212302.A7883@rapier.smartspace.co.za> <3AB791FA.98332316@pacbell.net> <3AB79688.B8113E0C@pacbell.net>

next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, 20 Mar 2001 at 09:42:33 -0800, richard childers wrote:

[ 85 lines of headers I don't care about removed and almost non-readable
  formatting fixed so I can actually read this ]

> > Neil Blakey-Milner complains:
> >
> > "You mean people like myself, Jeroen, Alex, Jim, Nik, and others?"
> >
> > "Oh.  We suck."
> >
> > "Never mind."
> 
> I don't see it being targeted personally but if you want to take it
> that way you are welcome to. I believe in free will ... and full
> responsibility.
> 
> On the other hand, if you cared about it you'd be subscribed to
> freebsd-questions and you wouldn't need people surreptitiously
> forwarding my messages to you; you would have spoken up much sooner,
> in defense of your group; you'd be proactively responding to
> negative feedback instead of getting defensive.

I am subscribed to freebsd-questions and a bunch of other lists, and so
is Neil.  I haven't replied to this thread because it's pretty
pointless, and I have more important things to do than contribute to a
bitchfest about our documentation by people who've never bothered to
contribute any (Mike and Neil excluded).

[snip..]

> Apparently you have not received all of the complaints that were
> voiced about documentation, if you are only replying to my comments,
> and no one else's. Whomever was forwarding my comments to you may
> have done you a disservice by not providing the entire exchange; of
> course, we could argue that you did yourself a disservice by not
> acquainting yourself with the topic at hand before commenting, also.

I've received them all and pretty much ignored them for one simple
reason.  If you don't like something about the documentation, SEND A
PATCH TO FIX IT.  This is an open source project here, people.  If you
don't like something, you have the ability to change it.  Bitching about
it on a list where it doesn't belong (-questions), and sending no PRs,
etc., is only going to serve to piss off those of us who do contribute.

If you can't wrap your brain around HTML, submit plain text.  Sure,
it'll probably take longer to get committed because it needs to be
marked up, etc., but eventually someone will look at it and
add/update/remove/whatever it.  The excuse that "I can't contribute
because DocBook is hard" just doesn't fly.

This is the last message I'm going to send about this nonsense.  The
choice is simple -- either send patches, or shut up about it.

- jim

-- 
- jim mock <mij@osdn.com> - O|S|D|N - open source development network -
- http://www.freebsdzine.org/ - jim@freebsdzine.org - jim@FreeBSD.org -

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-questions" in the body of the message




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