From owner-freebsd-doc Thu May 31 6: 3:23 2001 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 8058937B423; Thu, 31 May 2001 06:03:17 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.11.3/8.11.3) id f4VD2e307745; Thu, 31 May 2001 14:02:40 +0100 (BST) (envelope-from nik) Date: Thu, 31 May 2001 14:02:39 +0100 From: Nik Clayton To: Randy Pratt Cc: Nik Clayton , Murray Stokely , freebsd-doc@FreeBSD.ORG Subject: Re: Illustrated Installation Guide Message-ID: <20010531140239.A2713@catkin.nothing-going-on.org> References: <01053012311102.00379@k6-2.weeble.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-md5; protocol="application/pgp-signature"; boundary="ZGiS0Q5IWpPtfppv" Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <01053012311102.00379@k6-2.weeble.com>; from rpratt@ezwv.com on Wed, May 30, 2001 at 12:31:11PM -0400 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 --ZGiS0Q5IWpPtfppv Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, May 30, 2001 at 12:31:11PM -0400, Randy Pratt wrote: > I finished the first pass of the installation guide in sgml format. Since= =20 > this is my first attempt, I'm sure there's still work that needs to be do= ne=20 > (sgml and content). >=20 > I've no objections to any adding/cutting/editing to make the documents be= tter=20 > or more general. I'd like Nik to decide how to best proceed with handlin= g=20 > the committing/revisions. I'm a little fuzzy on those details. Some bullet points as they occur. * commit content changes and whitespace changes separately * It's probably worth breaking this down in to chapter.sgml files before import. * If we can, I'd like to get as many of the .png images converted to the .scr format instead as possible -- otherwise we'll be bloating=20 the repo with the PNG images unecessarily. * In the "Documentation" section, does it need to include the documentation that's with the installer verbatim, or is it just sufficient to show the user that it's there? Including it verbatim adds to the work required to maintain this between releases. * s/cdrom/CDROM/ everywhere * I can't shake the nagging feeling that this should be in the Handbook, maybe with a slight reorganisation. . . Bring chapters 1, 2, 3, 4, 5, 6 together as sections in a chapter,=20 "Before you install". Chapters 7 through 13 become sections in a "Carrying out the install" chapter. Chapters 14 onwards become sections in a "Post-installation" chapter. Maybe. Or perhaps we need an "Installation" in the Handbook (as we have "Getting Started", "System Administration", "Network Communications" and other parts) which this could be the content of. * There are a couple of mini mark-up nits, but nothing major. I don't think any of these should be considered 'show stoppers' though. 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 --- --ZGiS0Q5IWpPtfppv Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.5 (FreeBSD) Comment: For info see http://www.gnupg.org iEYEARECAAYFAjsWQO8ACgkQk6gHZCw343U7TACfcyet+5Fx1sNzB4x7KONrMuYS XLYAni8VbB3Qs7O2MpDTKcRPXYwvik40 =SEvl -----END PGP SIGNATURE----- --ZGiS0Q5IWpPtfppv-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message