From owner-freebsd-doc Thu Mar 19 00:56:22 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id AAA22312 for freebsd-doc-outgoing; Thu, 19 Mar 1998 00:56:22 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from dt050n33.san.rr.com (@dt050n33.san.rr.com [204.210.31.51]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id AAA22307 for ; Thu, 19 Mar 1998 00:56:20 -0800 (PST) (envelope-from Studded@dal.net) Received: from dal.net (Studded@localhost [127.0.0.1]) by dt050n33.san.rr.com (8.8.8/8.8.8) with ESMTP id AAA18084; Thu, 19 Mar 1998 00:55:56 -0800 (PST) (envelope-from Studded@dal.net) Message-ID: <3510DD9B.1591459B@dal.net> Date: Thu, 19 Mar 1998 00:55:55 -0800 From: Studded Organization: Triborough Bridge & Tunnel Authority X-Mailer: Mozilla 4.04 [en] (X11; I; FreeBSD 2.2.6-BETA-0316 i386) MIME-Version: 1.0 To: Sue Blake CC: John Kenagy , Annelise Anderson , freebsd-doc@FreeBSD.ORG Subject: Re: doc "renovation" project volunteer References: <19980319163714.47520@welearn.com.au> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org [ I'm keeping the cc list because I'm not sure who all is on -doc yet. If you are, please let me know and I'll avoid cross-posting in the future.] Sue Blake wrote: > > On Wed, Mar 18, 1998 at 10:58:34PM -0600, John Kenagy wrote: > > > A vision of where this is to go and an overall collaborative authority > > are necessary for success. Shall we talk about this? > > > > The documents must deal first and foremost with the needs of a new user. > > One who does not know much other that they want to try FreeBSD. The > > documentation as it stands now did not help me when I started with > > 2.1.5 (downloaded and installed from dos partition). I agree with John on all points here. I'm sorry if he's missed the discussion regarding "the vision thing," but if he wants to write me privately I'll send him copies of my posts on the current plans and priorities. Mine is not the only voice, however I'm coordinating the short term project on updating the FOO.TXT stuff that goes in the root directory of the CD. > A new mailing list has just been started for newbies. While the > documentation project is important, it is at least as important that > freebsd-newbies list be seen as something _for_ newbies to enjoy rather than > something to keep them either out of the way or doing useful work. I don't see how -newbies and -doc have any relationship at all. They exist for entirely different purposes. > Having said that, I think that as a newbie I can draw on some of its members > to provide a willing documentation readership to give you experts some > feedback, so long as it doesn't overrun the newbies list in its formative > stages. We're an extremely sensitive lot and easily misinterpret. I'm not sure I understand what you mean. You want to be in charge of picking people to review docs? Why can't members of the -doc team who want their stuff to be reviewed just post to -newbies and ask for help? > I have volunteered before to review any documentation that is offered, but > it would be even better to have more than one newbie perspective. What I > propose is to announce in freebsd-newbies when specific help is required, > coordinate that help, and report back here. On the flip side, if newbies say > they're wanting something in particular in the way of docs I can gather > their thoughts together, present them here, and report back to -newbies. > That way you don't get bored or annoyed by incompetence and they don't get > made to feel small or under scrutiny. Of course this doesn't preclude any > other methods, but provides a workable structure. Hmmmm. I know I'll be on the -newbies list, and I would suggest that anyone else seriously interested in producing documentation to be on and read -newbies and -questions. If we're not paying attention to the needs of the users, our efforts will be considerably less effective. Also, although you are welcome to present your perspective on what those needs are, channeling input from various users through one person eliminates the chief virtue of soliciting various perspectives. I don't mean to sound negative, but I can't help thinking that you are trying to make things more complicated than they need to be. Doug -- *** Chief Operations Officer, DALnet IRC network *** *** Proud operator, designer and maintainer of the world's largest *** Internet Relay Chat server. 5,328 clients and still growing. *** Try spider.dal.net on ports 6662-4 (Powered by FreeBSD) To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message