From owner-freebsd-doc Thu May 10 17:26: 9 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 EE01937B422; Thu, 10 May 2001 17:26:05 -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 f4B0Q4d10649; Thu, 10 May 2001 17:26:04 -0700 (PDT) Received: (from bmah@localhost) by bmah-freebsd-0.cisco.com (8.11.3/8.11.1) id f4B0Q5R12888; Thu, 10 May 2001 17:26:05 -0700 (PDT) (envelope-from bmah) Message-Id: <200105110026.f4B0Q5R12888@bmah-freebsd-0.cisco.com> X-Mailer: exmh version 2.3.1 01/19/2001 with nmh-1.0.4 To: "lee z." Cc: Nik Clayton , "Bruce A. Mah" , doc@freebsd.org Subject: Re: install handbook In-Reply-To: References: Comments: In-reply-to "lee z." message dated "Wed, 09 May 2001 16:40:48 -0000." From: bmah@freebsd.org (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_-1648637974P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Thu, 10 May 2001 17:26:05 -0700 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org --==_Exmh_-1648637974P Content-Type: text/plain; charset=us-ascii [long, modified HTML document] Hi Lee-- OK, here's a few comments on this. Hopefully you'll take them as the constructive criticism they are intended: 1. First, the HTML page you modified was originally written in another markup language called DocBook. Part of the process of building the Handbook (and all of the other FreeBSD documents) involves running a program to render the SGML into HTML, PDF, text, or whatever. What I'm getting at is that any changes need to be applied to the SGML source. (The SGML source for this part of the handbook lives in the doc/ tree, in doc/en_US.ISO_8859-1/books/handbook/install/chapter.sgml) 2. Related to the above, SGML more concerned with what the different parts of a document *are* than what the *look like*. A lot of the cosmetic appearance of the Handbook Web pages are defined in the "stylesheets" the control the conversion process. A document's appearance in printed output (e.g. a PDF file designed to be printed) may be quite different than the corresponding set of HTML pages, even though the document was generated from the same set of source files. The point of #1 and #2 is that just going in and hacking on the HTML you see on the Web site is not likely to be real useful, at least not directly. 3. I was trying to figure out the point of turning the different sections into tables. I guess I had something else in mind (did you look at the pointer I sent you to someone else's suggestion?). 4. We're debating the idea of taking this part of the handbook out. However, there will still be a supported hardware list in the release notes; since as I indicated it shares much of the same formatting as said list in the Handbook, it also has some of the same problems. Please note that the supported hardware list in the release notes is the only one being actively maintained, and that it's *much* longer than the corresponding handbook chapter. I hope you are not discouraged by these comments. The takeaway message I'd like you to get is that the problem is a little different than what you might have thought it was. But we still welcome your help! Thanks! Bruce. --==_Exmh_-1648637974P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.5 (FreeBSD) Comment: Exmh version 2.2 06/23/2000 iD8DBQE6+zGd2MoxcVugUsMRAmUOAKCAkhYOAucvJxkEtEll+cdiDU94hACgzgt/ l8diwmLscWHULmiQXx5s9S4= =ELKZ -----END PGP SIGNATURE----- --==_Exmh_-1648637974P-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message