Date: Tue, 27 Jun 2000 01:50:13 -0700 From: Jim Mock <jim@FreeBSD.org> To: Nik Clayton <nik@FreeBSD.ORG> Cc: doc@FreeBSD.ORG, dgl@bsdi.com, papowell@astart.com, ceren@magnesium.net, ryan@ryan.net, murray@bsdi.com Subject: Re: Splitting the Handbook Message-ID: <20000627015013.D12152@luna.osd.bsdi.com> In-Reply-To: <20000625195506.E470@kilt.nothing-going-on.org>; from nik@FreeBSD.ORG on Sun, Jun 25, 2000 at 07:55:06PM %2B0000 References: <20000625195506.E470@kilt.nothing-going-on.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sun, 25 Jun 2000 at 19:55:06 +0000, Nik Clayton wrote: > This has been on the cards for ages. > > IMHO, the Handbook, as it stands, is unwieldy. It's too big, it > tries to cater to too many audiences (someone installing FreeBSD, > someone using FreeBSD, someone trying to develop with FreeBSD, someone > who wants to hack on FreeBSD), and there's no one person that 'owns' > it. Indeed. > I want to break the Handbook up in to smaller chunks. We're doing > this already -- the recent creation of the Porter's Handbook reflects > this, as does the work that Jeroen's doing on the Developer's > Handbook. > > [ In fact, if rumour is to be believed, Jim Mock spent most of last > night locked in his hotel room putting together a "New Users > Handbook" -- given the amount of alcohol on offer that's > dedication. ] I almost finished it that night too ;-P I've since added the ``Unix Basics'' chapter to it. The HTML output is available at http://soupnazi.org/~jim/FreeBSD/newuser-handbook/ and the source is available at http://soupnazi.org/~jim/FreeBSD/newuser.tgz. Feedback is welcome. > I also think this would make the job of merging in documentation from > other projects (and, in particular, forming a "BSD Documentation > Project") considerably easier. Agreed. - jim -- /* jim mock - berkeley software design, inc - open source division */ /* documentation manager - jim@FreeBSD.org - jim@luna.osd.bsdi.com */ 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?20000627015013.D12152>