Date: Tue, 6 Apr 1999 11:28:37 +1200 From: "Dan Langille" <junkmale@xtra.co.nz> To: Nik Clayton <nik@nothing-going-on.demon.co.uk> Cc: doc@freebsd.org Subject: Re: Organisation change for the Handbook Message-ID: <19990405232957.IVHP5596385.mta1-rme@wocker> In-Reply-To: <19990405234615.B6083@catkin.nothing-going-on.org>
index | next in thread | previous in thread | raw e-mail
On 5 Apr 99, at 23:46, Nik Clayton wrote: > People seem to be a bit more active on this list recently, so I'm > reposting something from November last year. Now that the DocBook > conversion is done I'm looking at this in more detail, and would > appreciate comments. I missed the original post as I was on hoilday and unsubscribed. I'm sorry I missed it back then. > The Handbook's target audience needs to be understood. The Handbook > should be catering for the spectrum of people who, at one end, have > never heard of Unix or FreeBSD before through to those people who are > very familiar with FreeBSD, but who need a useful reference, or want to > know as much as possible about a topic they haven't yet covered (for > example, printing). This is great! And what Darren was talking about. > Note that it should be assumed that the reader has at least some OS > experience. I think it is biting off more than we can chew if we assume > we need to teach OS basics as well (although that could be a topic for > another book in the series, which would give the user enough knowledge > to then move on to some of the others). That doesn't mean we can't have a newbie section that says here's the editor, here's the basic commands, etc. One page intro. We are not here to educate computer novices. Merely FreeBSD novices. > Here's how I see the new books shaping up. Note that a lot of the > content doesn't exist yet. My comments are bracketed by '[' and ']' > after each book. What I like about it is that each section is *not* self contained. That allows the author of one section to refer to existing work (e.g. Add the IPFILTER option to your kernel). It makes the writing much easier. Not to mention the reading. -- Dan Langille The FreeBSD Diary http://www.FreeBSDDiary.com/freebsd To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the messagehome | help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19990405232957.IVHP5596385.mta1-rme>