From owner-freebsd-doc Mon Jul 23 2:13:41 2001 Delivered-To: freebsd-doc@freebsd.org Received: from amsmta02-svc.chello.nl (mail-out.chello.nl [213.46.240.7]) by hub.freebsd.org (Postfix) with ESMTP id 44DC337B401; Mon, 23 Jul 2001 02:13:35 -0700 (PDT) (envelope-from asmodai@wxs.nl) Received: from daemon.chronias.ninth-circle.org ([62.163.96.180]) by amsmta02-svc.chello.nl (InterMail vK.4.03.02.00 201-232-124 license dd4a379df8e387594186908c65258374) with ESMTP id <20010723091257.KDUU10337.amsmta02-svc@daemon.chronias.ninth-circle.org>; Mon, 23 Jul 2001 11:12:57 +0200 Received: (from asmodai@localhost) by daemon.chronias.ninth-circle.org (8.11.3/8.11.3) id f6N9DPA28197; Mon, 23 Jul 2001 11:13:25 +0200 (CEST) (envelope-from asmodai) Date: Mon, 23 Jul 2001 11:13:25 +0200 From: Jeroen Ruigrok/Asmodai To: Murray Stokely Cc: Andrew Boothman , Alexey Zelkin , Murray Stokely , freebsd-doc@FreeBSD.ORG, Nik Clayton Subject: Re: Moving chapters around in the Handbook Message-ID: <20010723111324.V79615@daemon.ninth-circle.org> References: <20010716185834.D77647@meow.osd.bsdi.com> <20010719134759.B79615@daemon.ninth-circle.org> <3B57A50B.9010101@cream.org> <20010720081706.H79615@daemon.ninth-circle.org> <20010720172437.A6118@ark.cris.net> <20010721145108.N79615@daemon.ninth-circle.org> <3B59BBEA.3060600@cream.org> <20010722141425.Q79615@daemon.ninth-circle.org> <20010722230135.A88988@meow.osd.bsdi.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20010722230135.A88988@meow.osd.bsdi.com> User-Agent: Mutt/1.3.19i Organisation: Ninth-Circle Enterprises Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org -On [20010723 08:20], Murray Stokely (murray@osd.bsdi.com) wrote: >On Sun, Jul 22, 2001 at 02:14:25PM +0200, Jeroen Ruigrok/Asmodai wrote: >> Murray, please clarify the scope of what the handbook you are working >> on actually is and who/which type of users it aims at. > > I haven't quite gotten around to writing the section of Chapter 1 >that will address exactly this question. Scope should be the first. :) Without a proper scope you cannot write the rest of the document. :) >The Handbook as it stands now has a fairly broad scope and I think that >is fine as long as we are careful. *nod* >We want to help users get it installed, setup X, configure a home >network, run Internet servers, etc. Clearly the book is getting quite >large and Nik and I have talked about splitting it up very soon after >publication of the 2nd Edition. I think there is a lot of value in a >unified 2nd Edition so I'd like to hold off for a couple of months >until that happens. Sure no problem. Makes a lot of sense as well. >> Nik, I am considering more and more to repocopy the handbook and make >> what Murray is working on (in awaiting his answer) the end-user handbook >> and the new copy an administrator's handbook. >> I think the latter will definately benifit those on the -isp list, let >> alone those who use FreeBSD for Internet backbone routing and all those >> nifty things. Maybe network backups, clustering. I doubt any normal >> user needs those. And I sincerely doubt that that needs to be in the >> (end-user) Handbook. > > I completely agree that this is the way we need to go. I just want >to wait a couple of months before splitting up the document. I have a >few more meaty sections I want to contribute and I don't think we've >quite reached a "critical mass" for splitting the Handbook yet anyway, >although we are certainly getting there. Like I said above, no problem. I was not proposing to do it right now, since I know you and Chern are working on the new edition to be publicised. I was merely gathering information from you and the other regular contributors about the split. > If you've really got an itch, then it might be better spent on >developing docs.freebsd.org or some other place where we can actually >display all of this documentation. Our current setup, with a single >link for the Handbook in our navigation bar and the rest of the books >thrown in with tutorials is less than ideal. Oh, I have an itch alright and taking it out on www and the developer's handbook. :) I'll look at the navigation stuff. I'll also see how bad converting the webpages to real SGML will be. -- Jeroen Ruigrok van der Werven/Asmodai asmodai@[wxs.nl|freebsd.org|xmach.org] Documentation nutter/C-rated Coder, finger asmodai@ninth-circle.dnsalias.net http://www.freebsd.org/doc/en_US.ISO8859-1/books/developers-handbook/ Nothing yet from nothing ever came... To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message