From owner-freebsd-doc Mon Mar 16 23:38:33 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id XAA23221 for freebsd-doc-outgoing; Mon, 16 Mar 1998 23:38:33 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from allegro.lemis.com (allegro.lemis.com [192.109.197.134]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id XAA23215 for ; Mon, 16 Mar 1998 23:38:27 -0800 (PST) (envelope-from grog@lemis.com) Received: from freebie.lemis.com (freebie.lemis.com [192.109.197.137]) by allegro.lemis.com (8.8.7/8.8.5) with ESMTP id SAA08946; Tue, 17 Mar 1998 18:08:17 +1030 (CST) Received: (from grog@localhost) by freebie.lemis.com (8.8.8/8.8.7) id SAA05511; Tue, 17 Mar 1998 18:08:16 +1030 (CST) (envelope-from grog) Message-ID: <19980317180815.17122@freebie.lemis.com> Date: Tue, 17 Mar 1998 18:08:15 +1030 From: Greg Lehey To: John Kenagy , "Jordan K. Hubbard" Cc: Studded , FreeBSD-doc@FreeBSD.ORG Subject: Re: Documentation plan? References: <27422.890094715@time.cdrom.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.89i In-Reply-To: ; from John Kenagy on Mon, Mar 16, 1998 at 11:15:16PM -0600 WWW-Home-Page: http://www.lemis.com/~grog Organization: LEMIS, PO Box 460, Echunga SA 5153, Australia Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-41-739-7062 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Mon, 16 March 1998 at 23:15:16 -0600, John Kenagy wrote: > On Mon, 16 Mar 1998, Jordan K. Hubbard wrote: > >>> I don't think you can. Trying to impose that sort of discipline on >>> the handbook is equivalent to tell the hackers when to commit their >>> code. It's a volunteer operation, and people will continue to do >>> things their way, frequently with the policy of content over style. >> >> I wasn't suggesting that the original authors have this imposed on >> them, simply that an "editor" needed to go through and turn the >> original copy into something closer to what makes a decent handbook. >> >> Considering the difference in quality with the results, I don't think >> that anyone would object, nor does the average engineer feel as >> strongly about their textual output (which most feel sucks anyway and >> only do it as a last resort) as they do about their code. > If I may, > > Having followed this thread a little, and having volunteered to do a > bit on NIS at Doug White's prodding (I ask too many questions ;-)), > I would say that the lack of an editor holds back the overall > FreeBSD project. (Don't anyone get mad now.) > > The on line documentation, while good, puts a new user into heavy > sensory overload. It did to me, when I first started with FreeBSD. > I sympathize with all the newbies who ask the obvious questions. > Its obvious to me - now, but not then, nor when I venture onto new > ground. > > I am not an expert by any means, but my thrashings getting NIS to work > gives me an insight into what the new user will bump into. I feel I > would like to help by telling someone else how to set NIS up (or > whatever else), but I'm not really a technical writer. > > So, I need an editor. This is a volunteer project and I would feel > more comfortable putting something together then having it gone > through by an editor, or an editorial committee. Maybe people might > be more forthcoming if they felt they could rely on that. > > I don't mean a professional editor, just a different pair of eyes. > A little distance makes a huge difference. I would even presume to > vounteer to be one of those pairs. Interesting idea. Yes, I think you're right. I'm prodding somebody to volunteer, but won't mention names at this point. Failing an editor, at least a system of reviewing would be a good idea. What do other people think? Greg To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message