From owner-freebsd-doc Sun Jan 12 9:56:15 2003 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id BB60A37B401 for ; Sun, 12 Jan 2003 09:56:12 -0800 (PST) Received: from sccrmhc01.attbi.com (sccrmhc01.attbi.com [204.127.202.61]) by mx1.FreeBSD.org (Postfix) with ESMTP id C533243F5B for ; Sun, 12 Jan 2003 09:56:11 -0800 (PST) (envelope-from bmah@employees.org) Received: from bmah.dyndns.org (12-240-204-110.client.attbi.com[12.240.204.110]) by sccrmhc01.attbi.com (sccrmhc01) with ESMTP id <20030112175610001003oncoe>; Sun, 12 Jan 2003 17:56:10 +0000 Received: from intruder.bmah.org (localhost [IPv6:::1]) by bmah.dyndns.org (8.12.6/8.12.6) with ESMTP id h0CHu6A8063154; Sun, 12 Jan 2003 09:56:06 -0800 (PST) (envelope-from bmah@intruder.bmah.org) Received: (from bmah@localhost) by intruder.bmah.org (8.12.6/8.12.6/Submit) id h0CHu5Mh063151; Sun, 12 Jan 2003 09:56:05 -0800 (PST) Message-Id: <200301121756.h0CHu5Mh063151@intruder.bmah.org> X-Mailer: exmh version 2.5+ 20021120 with nmh-1.0.4 To: Udo Erdelhoff Cc: freebsd-doc@FreeBSD.ORG Subject: Re: 5.0 release docs (was Re: HEADSUP: doc/ tree tagging) In-Reply-To: <20030112165544.GD66579@nathan.ruhr.de> References: <20030110124620.GB91718@nathan.ruhr.de> <200301101643.h0AGh3cO028415@intruder.bmah.org> <200301102123.h0ALNFIf031693@intruder.bmah.org> <20030110221508.GE91718@nathan.ruhr.de> <200301110435.h0B4Zbx5038652@intruder.bmah.org> <20030111172153.GA375@straylight.oblivion.bg> <200301111736.h0BHaxph047160@intruder.bmah.org> <20030112103609.GC371@straylight.oblivion.bg> <20030112141819.GC66579@nathan.ruhr.de> <200301121620.h0CGKJT1060605@intruder.bmah.org> <20030112165544.GD66579@nathan.ruhr.de> Comments: In-reply-to Udo Erdelhoff message dated "Sun, 12 Jan 2003 17:55:45 +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_1617906373P"; micalg=pgp-sha1; protocol="application/pgp-signature" Content-Transfer-Encoding: 7bit Date: Sun, 12 Jan 2003 09:56:05 -0800 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 --==_Exmh_1617906373P Content-Type: text/plain; charset=us-ascii If memory serves me right, Udo Erdelhoff wrote: > On Sun, Jan 12, 2003 at 08:20:19AM -0800, Bruce A. Mah wrote: > > I was not so concerned about making the translation teams track this > > change on short notice (they don't). I was more worried about the new > > attributes adding a bunch of deltas that are not immediately > > distinguishable from real content changes that *do* need to be tracked. > > Hmm, did I overlook something? As far as I remember, the changes were > basically limited to adding id-attributes to various opening tags. > At worst, they may also add #foo to some link entities. No you didn't miss anything. I'm just being conservative in trying to limit the amount of headache caused to translators, especially given the shorter-than-normal doc slush. If there's no headache involved, I withdraw my objections. > > Ah...sorry, it's not obvious to me at all. :-p > > I *do* need new glasses, it seems. Or did I try to make reality make > my wishes. Anyway, I will take a closer look once the local web build > has finished- > > > On both the en_US and de_DE Web sites, it looks to me like the release > > documentation pages reference the html-split files, not html. So don't > > you mean to get rid of html? > > Nope, the idea is to get rid of html-split. Ah, OK, then. I like this even more. > > (Gratuitous comment: I don't like html-split for the release > > documentation because it's too hard to do intra-document searches. But > > that's an issue for another time.) > > Exactly that is one of the reasons why I want to get rid of html-split. > The other is that there is next to no good reason for html-split, > because as far as the release notes are concerned, it just produces > one or two files with 2-3% of the content and one big file with the > remainder. And the split points do not make sense to me at all. This may have to do with places where I put id attributes (for the purposes of making intra-document links, but having nothing to do with splitting the document). > > No problem. Basically, we'd do the cleanup and then immediately run a > > rebuild. > > Talking about rebuilds: I think it would be a good idea to change the > web site build to > a) do complete builds (i.e. remove all checked-out copies and rebuild > everythin) only ONCE per Sunday, not during every run on Sunday Huh? > b) build the non-english versions more often than twice per day. Sure, sounds good. These are issues ultimately to be decided by webmaster@, but they sound pretty reasonable to me. Bruce. --==_Exmh_1617906373P Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.0 (FreeBSD) Comment: Exmh version 2.5+ 20020506 iD8DBQE+Iaw12MoxcVugUsMRAgfEAJ9E4YA6eILycWEX9kR5gX4sPDnWzACgsJkp V2qmrPZTAHVqbyKwkUZxxlo= =6M0d -----END PGP SIGNATURE----- --==_Exmh_1617906373P-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message