From owner-freebsd-questions Tue Mar 20 10:39: 3 2001 Delivered-To: freebsd-questions@freebsd.org Received: from snarf.osdn.com (snarf.osdn.com [209.192.217.153]) by hub.freebsd.org (Postfix) with ESMTP id B320837B718 for ; Tue, 20 Mar 2001 10:38:59 -0800 (PST) (envelope-from mij@osdn.com) Received: from guinness.osdn.com (root@localhost [127.0.0.1]) by snarf.osdn.com (8.11.3/8.11.3) with ESMTP id f2KIYt208907; Tue, 20 Mar 2001 13:34:56 -0500 (EST) (envelope-from mij@osdn.com) Received: by guinness.osdn.com (Postfix, from userid 1000) id E76D9173; Tue, 20 Mar 2001 13:34:49 -0500 (EST) Date: Tue, 20 Mar 2001 13:34:49 -0500 From: Jim Mock To: richard childers Cc: Neil Blakey-Milner , Doug Young , Duke Normandin <01031149@3web.net>, David Johnson , Mike Meyer , freebsd-questions@FreeBSD.ORG Subject: Re: documentation issues generally Message-ID: <20010320133449.B7004@guinness.osdn.com> Reply-To: mij@osdn.com 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> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.3.16i In-Reply-To: <3AB79688.B8113E0C@pacbell.net>; from fscked@pacbell.net on Tue, Mar 20, 2001 at 09:42:33AM -0800 Sender: owner-freebsd-questions@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG 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 - 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