From owner-freebsd-doc Sun Apr 7 12:24:53 2002 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (pc-62-31-42-140-hy.blueyonder.co.uk [62.31.42.140]) by hub.freebsd.org (Postfix) with ESMTP id 6937E37B400; Sun, 7 Apr 2002 12:24:42 -0700 (PDT) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.3/8.11.3) id g37Fc9k30827; Sun, 7 Apr 2002 16:38:09 +0100 (BST) (envelope-from nik) Date: Sun, 7 Apr 2002 16:38:09 +0100 From: Nik Clayton To: Murray Stokely Cc: Giorgos Keramidas , freebsd-doc@freebsd.org Subject: Re: Splitting the Handbook? (was: [a couple of new doc PRs]) Message-ID: <20020407163809.R30474@canyon.nothing-going-on.org> References: <20020404062954.6607E2E827@mail.freebsdmall.com> <20020406221709.GA1181@hades.hell.gr> <20020406231126.GP5732@freebsdmall.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="JB7KW7Ey7eB5HOHs" Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <20020406231126.GP5732@freebsdmall.com>; from murray@FreeBSD.org on Sat, Apr 06, 2002 at 03:11:26PM -0800 Organization: FreeBSD Project 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 --JB7KW7Ey7eB5HOHs Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Sat, Apr 06, 2002 at 03:11:26PM -0800, Murray Stokely wrote: > On Sun, Apr 07, 2002 at 01:17:09AM +0300, Giorgos Keramidas wrote: > > This is hard to search though. It's difficult for a newcomer to find h= is > > way around in this huge document. It is time, I think to separate the > > Handbook in smaller parts. The main thing that I was thinking about is= how >=20 > It's been time for over 4 years, we've just never identified the > first concrete step to move in that direction. Each chapter becomes its own book, with a copy of the content in the existing Preface as its own Preface. Pretty much. > I think that the 3rd printed edition (which I've obviously been > doing some initial planning for) should be split into two books along > these lines. I was planning on a "User's Guide" and an > "Administrator's Guide". If the FreeBSD Documentation Project makes > further subdivisions into smaller books, they can be mapped into these > two categories for print publication purposes. A collection of > smaller books is not practical for U.S. retail shelves, although if > done right it can make online browsing easier. For print, you want the DocBook element. ... ... ... ... *or* some XSLT stylesheets that can maps the to a , the s to s, and so on. Eventually, the "FreeBSD Handbook" becomes the "FreeBSD Bookshelf". Now, if I could just get funding :-) N --=20 FreeBSD: The Power to Serve http://www.freebsd.org/ (__) FreeBSD Documentation Project http://www.freebsd.org/docproj/ \\\'',) \/ \= ^ --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- .\._/= _) --JB7KW7Ey7eB5HOHs Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: For info see http://www.gnupg.org iEYEARECAAYFAjywZ+AACgkQk6gHZCw343UFuwCfW/XfADXilqJk2PXIo6oB6ZZO flsAn3ZmhbDAk+s+tNl/PCJmSF4jrt16 =gLnb -----END PGP SIGNATURE----- --JB7KW7Ey7eB5HOHs-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message