Date: Wed, 18 Mar 1998 00:51:40 -0600 (CST) From: John Kenagy <jktheowl@bga.com> To: Sean Kelly <kelly@plutotech.com> Cc: Greg Lehey <grog@lemis.com>, "Jordan K. Hubbard" <jkh@time.cdrom.com>, Studded <Studded@dal.net>, Sue Blake <sue@welearn.com.au>, FreeBSD-doc@FreeBSD.ORG Subject: Re: Documentation plan? Message-ID: <Pine.BSF.3.95q.980318002124.316E-100000@barnowl.roost.net> In-Reply-To: <350EA135.3506B0CE@plutotech.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, 17 Mar 1998, Sean Kelly wrote: > > 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? > > Absolutely. Editors and reviewers provide quite valuable and yet > undervalued services to authors. It's amazing, after looking over > things I've written years ago that were never reviewed, just how > terrible and confusing certain passages sounded. It made perfect sense > when I composed them, yet the comprehension in thinking about what's to > be written doesn't quite pass into what's actually written. > Rather like the brilliant Ideas I get falling to sleep. Count me in as a reader/reviewer volunteer also. I am also a pending victim of such readers with an aforementioned project. Needed is a format for submitted drafts. I need that now. Any such project needs "style sheets" to help structure the input. I think at least two or three layers are needed. A group of reviewers who jury the submissions and work at an interactive level with the author, an editor/editorial board to do the final cut - giving the author a yes/no review, and finally a production level that produces the work. Any such structure takes time to build. I detect some sentiment for taking that time, with which I concur. The documents need to be done with care so that the first iteration can get the newest user going. There is a sense of urgency as well and that should be directed at the same target - with the READMEs etc. and a "startup" web page - "step 1, step 2, etc." John To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.BSF.3.95q.980318002124.316E-100000>