From owner-freebsd-doc Thu Oct 29 15:25:20 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id PAA12025 for freebsd-doc-outgoing; Thu, 29 Oct 1998 15:25:20 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from time.cdrom.com (time.cdrom.com [204.216.27.226]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id PAA12019 for ; Thu, 29 Oct 1998 15:25:18 -0800 (PST) (envelope-from jkh@time.cdrom.com) Received: from time.cdrom.com (jkh@localhost.cdrom.com [127.0.0.1]) by time.cdrom.com (8.8.8/8.8.8) with ESMTP id PAA07153; Thu, 29 Oct 1998 15:25:01 -0800 (PST) (envelope-from jkh@time.cdrom.com) To: Nik Clayton cc: doc@FreeBSD.ORG Subject: Re: RFC: Handbook reorganisation In-reply-to: Your message of "Thu, 29 Oct 1998 22:11:06 GMT." <19981029221106.19143@nothing-going-on.org> Date: Thu, 29 Oct 1998 15:25:01 -0800 Message-ID: <7149.909703501@time.cdrom.com> From: "Jordan K. Hubbard" Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > for the past seven months. I think it's reasonably widely acknowledged that > the Handbook could use some reorganisation (and, eventually, tighter > editing), and this is how I'm (currently) thinking of doing it. Yes! > The layout that I'm proposing will look something like this > > This looks to be a major improvement, yes. I've long looked at the handbook and sort of tilted my head sideways like an irish setter, going "hmmmm, the ordering here is just *wrong* but I just don't feel like getting that bloody with SGML today." I'm very happy to see someone else willing to walk in and get bloody to the elbows here. :-) > Pretty good. Covers how to install FreeBSD (could use expanding, with > screenshots). A basic introduction to Unix, and how to use the ports > system. For an interesting example of how to do it without actual screenshots, see http://www.treefort.org/~rpratt/bsdinstall/bsdnewbie.html > Split up "Serial Communications" and "PPP and SLIP". Create a "Serial > Overview" chapter, and a "Dialling in to remote > hosts/receiving calls" chapter. This section could also really use a quick start guide for something other than pppd with a bunch of gross kermit dialing scripts (which are actually my own early linkup examples, polished and recycled through the handbook by a russian author :-). What's at http://flag.blackened.net/freebsd/dynij.html represents a fairly good approach to this. > The more I look at this, the more I think that calling the Handbook a single > DocBook 'book' is a mistake. Having it as a 'set' (which can contain > multiple books) would be more useful. Works for me. > Feedback welcomed. And yes, I am the one planning on donning the magic > hat of handbook editorship, picking up my trusty copy of Emacs (+3 to > manual dexterity, +3d6 to Control spells, but a massively increased > chance of a fumble) and fighting the SGML elements at the end of this > discussion. . . Hmmmmmm. Looks to me like the Docmeister hat which has been lying here unworn since John Fieber took an extended vacation may just have found its next owner, what do you think, folks? :-) - Jordan To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message