Date: Sun, 12 Jan 2003 09:56:05 -0800 From: "Bruce A. Mah" <bmah@FreeBSD.ORG> To: Udo Erdelhoff <ue@nathan.ruhr.de> Cc: freebsd-doc@FreeBSD.ORG Subject: Re: 5.0 release docs (was Re: HEADSUP: doc/ tree tagging) Message-ID: <200301121756.h0CHu5Mh063151@intruder.bmah.org> 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>
next in thread | previous in thread | raw e-mail | index | archive | help
--==_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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200301121756.h0CHu5Mh063151>