On Fri, Jan 30, 2009 at 08:28:39AM +1000, ryan lerch wrote: > I think we really need to define what the scope of the Release Notes > is going to be. Will it be just new features, known issues and > important bugfixes? > > or > > will it be all that + a mini installation guide? take the "Live" [1] > section as an example. Live images are nothing new in f10. Excellent point. The combined audience for the Release Notes has several objectives: * evaluating whether to try this release * feature high points * are there deleterious or advantageous changes? * (?) what's different from [Distro_X]? * first-timer trying to understand Fedora offerings * [Others?] IMHO, we want to duplicate content only judiciously, but reuse it effectively. The Release Notes and the Installation Guide are definitely trying to achieve different things, but we also want to make sure people finish looking at the Release Notes by saying, "Wow, that sure was informative. I feel ready to decide what to do now, and I know what my next action needs to be." > also after going though the release notes over the last couple of > days, i feel that they could also do with an overhaul on how the > information is structured and consequently presented... A solid > structure of the release notes would also make it significantly easier > to maintain the wiki <---> docbook relationship. No argument here! When we said we wanted fresh leadership on these docs, it wasn't lip service. I for one may pop up to discuss things as a fellow Docs contributor, but that's what mailing lists and a community process are for. I see any overhaul as natural, and something to be expected and welcomed. -- Paul W. Frields http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 http://redhat.com/ - - - - http://pfrields.fedorapeople.org/ irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug
Attachment:
pgpLRvBB1hb6W.pgp
Description: PGP signature
-- fedora-docs-list mailing list fedora-docs-list@xxxxxxxxxx To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-docs-list
