Date: Sat, 04 Aug 2007 09:47:15 -0700 From: "Bruce A. Mah" <bmah@freebsd.org> To: freebsd-doc@freebsd.org Subject: RFC: Removing installation notes from release documentation Message-ID: <46B4AD93.1050808@freebsd.org>
next in thread | raw e-mail | index | archive | help
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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?46B4AD93.1050808>