From owner-freebsd-doc@FreeBSD.ORG Sat Aug 4 16:47:20 2007 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BF80C16A419 for ; Sat, 4 Aug 2007 16:47:20 +0000 (UTC) (envelope-from bmah@freebsd.org) Received: from b.mail.sonic.net (b.mail.sonic.net [64.142.19.5]) by mx1.freebsd.org (Postfix) with ESMTP id B633613C45E for ; Sat, 4 Aug 2007 16:47:20 +0000 (UTC) (envelope-from bmah@freebsd.org) Received: from bruce-a-mahs-computer.local (hornet.kitchenlab.org [64.142.31.105]) (authenticated bits=0) by b.mail.sonic.net (8.13.8.Beta0-Sonic/8.13.7) with ESMTP id l74GlK1f015287 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sat, 4 Aug 2007 09:47:20 -0700 Message-ID: <46B4AD93.1050808@freebsd.org> Date: Sat, 04 Aug 2007 09:47:15 -0700 From: "Bruce A. Mah" User-Agent: Thunderbird 2.0.0.6 (Macintosh/20070728) MIME-Version: 1.0 To: freebsd-doc@freebsd.org X-Enigmail-Version: 0.95.2 OpenPGP: id=5ba052c3 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="------------enig7AD3DEDEE9CD00B6E980691C" Subject: RFC: Removing installation notes from release documentation X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 04 Aug 2007 16:47:20 -0000 This is an OpenPGP/MIME signed message (RFC 2440 and 3156) --------------enig7AD3DEDEE9CD00B6E980691C Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Howdy-- I'm thinking of removing the installation notes (i.e. INSTALL.TXT) from the release documentation set. They're not well-maintained, are poorly written (for which I take some responsibility), and they do a meager job of trying to duplicate information that is contained in Chapter 2 of the FreeBSD Handbook ("Installing FreeBSD"). The installation notes were originally intended to be a lightweight quickstart guide that users could read before actually having installed FreeBSD on their system. There are now several ways to get this information...in particular the Handbook is available on the FreeBSD Web site, and starting with FreeBSD 7.0 a complete documentation set is produced as one of the ISO images in the release build process. So I'd like to eliminate the installation notes. I'd do a pass through this document and try to pull any outstanding useful content into the Handbook. I've run this past other re@ folks and gotten no objections, and a couple of other doc@ committers working in this area have given the idea a general thumbs-up. Any comments? Bruce. --------------enig7AD3DEDEE9CD00B6E980691C Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.7 (Darwin) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org iD8DBQFGtK2X2MoxcVugUsMRAud8AJ4mA0tYaEcTa58ETGYiJzB/e4oBGgCg5QcK LkDTcbAu+iWRm/tCDFCi4Kw= =tLLR -----END PGP SIGNATURE----- --------------enig7AD3DEDEE9CD00B6E980691C--