On Wed, 2006-03-22 at 11:45 -0500, Jeremy Katz wrote: >> * Links don't work in Release Notes >> Rather frustrating, considering the size of the doc. >> Links within the document should work, if they >> look like regular links (color, cursor) > > Yeah. We didn't have HTML release notes until late in the game. At > that point, I noticed but it was a bit risky to be going and making > the necessary changes to have them work. > >> * External links in Release Notes are confusing >> These can't possibly work, it would be nice if we >> can disable them to avoid confusion. > > Hrm. Not sure how to handle this. They could conceivably work in > network installs, but are almost certainly a bad idea. Maybe the way > to do this is to do some processing on the release notes file before > we feed it to the viewer This was my thought too. A small XSL snippet and a specialized Makefile target for the Anaconda-destined build should take care of this. I don't think anyone would reasonably argue against the fact that you guys are using GtkHtml3 (right?) to render the notes in Anaconda now. But it would best not to mislead readers also. I am cc'ing the Docs list on this so we can capture the discussion, but a bug would be appreciated, filed against Fedora Documentation -> toolchain-devel. >> * Release Notes too big? >> I found them to be too big/verbose, especially for >> a light read during install. But maybe it's just me. > > Yep, the Docs project has rocked at getting lots of content. This has > the downside of there being lots of content. Double-edged sword... Hey, are you trolling for compliments? OK, OK, Anaconda ROCKS. ;-D (No, seriously.) In any case, I agree, the release notes are a little TOO sizable. I think the general tenor with having community-provided "beats" with a different author for each one means that everyone is under the impression their content is of paramount importance. With a very decentralized process the first time through, we erred on the side of inclusion, so as not to cheese anyone off by leaving out the one surprise that hit their particular edge case. :-) As we develop this process, which was new for FC5, I'm certain there should and will be a strong guiding personality to "wield the red pen" judiciously. -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/
Attachment:
signature.asc
Description: This is a digitally signed message part
-- fedora-devel-list mailing list fedora-devel-list@xxxxxxxxxx https://www.redhat.com/mailman/listinfo/fedora-devel-list
