From owner-freebsd-doc Wed May 9 8: 8:38 2001 Delivered-To: freebsd-doc@freebsd.org Received: from sj-msg-core-2.cisco.com (sj-msg-core-2.cisco.com [171.69.24.11]) by hub.freebsd.org (Postfix) with ESMTP id 444F537B422; Wed, 9 May 2001 08:08:35 -0700 (PDT) (envelope-from bmah@cisco.com) Received: from bmah-freebsd-0.cisco.com (bmah-freebsd-0.cisco.com [171.70.84.42]) by sj-msg-core-2.cisco.com (8.11.3/8.9.1) with ESMTP id f49F81H03665; Wed, 9 May 2001 08:08:01 -0700 (PDT) Received: (from bmah@localhost) by bmah-freebsd-0.cisco.com (8.11.3/8.11.1) id f49F83h98716; Wed, 9 May 2001 08:08:03 -0700 (PDT) (envelope-from bmah) Message-Id: <200105091508.f49F83h98716@bmah-freebsd-0.cisco.com> X-Mailer: exmh version 2.3.1 01/19/2001 with nmh-1.0.4 To: Nik Clayton Cc: "lee z." , doc@FreeBSD.ORG Subject: Re: install handbook In-Reply-To: <20010509094813.A23085@canyon.nothing-going-on.org> References: <20010509094813.A23085@canyon.nothing-going-on.org> Comments: In-reply-to Nik Clayton message dated "Wed, 09 May 2001 09:48:13 +0100." From: "Bruce A. Mah" Reply-To: bmah@FreeBSD.ORG X-Face: g~c`.{#4q0"(V*b#g[i~rXgm*w;:nMfz%_RZLma)UgGN&=j`5vXoU^@n5v4:OO)c["!w)nD/!!~e4Sj7LiT'6*wZ83454H""lb{CC%T37O!!'S$S&D}sem7I[A 2V%N&+ X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-Url: http://www.employees.org/~bmah/ Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==_Exmh_760827418P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Wed, 09 May 2001 08:08:03 -0700 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --==_Exmh_760827418P Content-Type: text/plain; charset=us-ascii If memory serves me right, Nik Clayton wrote: > On Tue, May 08, 2001 at 11:42:26PM +0000, lee z. wrote: > > Would you mind if I rewrite the supported hardware page so that > > it's easier to navigate? As an ordered list right now it's cumbersome. > > Perhaps I could add some links, or menus, or tables, etc. > > We're certainly open for suggestions and contributions to make it easier > to read. > > Can I suggest that you produce a few samples showing what a handful of > entries would look like with any changes you want to make, so that we > can discuss them before you go and spend a lot of time on this? I'm probably getting ahead of things, so take these comments with a proverbial grain of salt. With RELNOTESng now committed to -CURRENT, I recommend that Lee take a look at the supported hardware list there as well. It's (unintentionally) very similar in form to the hardware list in the handbook, however it is more actively maintained. Garrett Wollman commented that the format of RELNOTESng's supported hardware list could stand some improvement, which I completely agree with (it's too hard to browse because of its length, for starters). He also suggested a tabular format. I think this is do-able, although perhaps not in exactly the form he suggested. More details in this message: <200104241721.NAA97189@khavrinen.lcs.mit.edu>. Eventually it'd be great if we could also further reduce duplication between the Handbook and our release documentation, but I'm not sure what's the best way to accomplish that either. Just some food for thought. I agree with Nik's suggestion of sending out some samples for comments first. Cheers, Bruce. --==_Exmh_760827418P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.5 (FreeBSD) Comment: Exmh version 2.2 06/23/2000 iD8DBQE6+V1T2MoxcVugUsMRAjuNAJ4ziceukqwjObQV3/1aFT/QafjNUACgveVY xdIoe4dJ478oTPacQnJpytE= =Gr7s -----END PGP SIGNATURE----- --==_Exmh_760827418P-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message