Thoughts on how to structure the release notes...

[Edward C. Bailey]

>>>>> "Jim" == Jim Cornette <cornette at insight.rr.com> writes:

Jim> The use of the categories from the group selection sounds like a good
Jim> idea. Maybe a bit more compression with the categories might be better
Jim> for a less cluttered page. Since the categories won't all need
Jim> commenting on. It might work out using the same selections.

That was my plan -- to eliminate all sections lacking any content...

Jim> I would like to see an install and upgrade section. The upgrade to
Jim> list programs removed or added, plus any additional hints on importing
Jim> the new programs or removing the orphaned programs from the upgraded
Jim> system.

I intend to keep the "packages added/removed/deprecated" sections that were
part of the FC1 release notes.  I doubt the types of hints you're looking
for will be part of that, however -- that kind of stuff doesn't tend to be
the sort of content sent to me.  Of course, if the community wants to start
work documenting those kinds of issues, I'll be more than happy to add the
resulting content... ;-)

Jim> On the install section. Things concerning what hardware needs special
Jim> attention and things related to known issues concerning the current
Jim> test or final release.

Um, isn't that what the release notes as a whole are supposed to do? :-)

                                    Ed
-- 
Ed Bailey        Red Hat, Inc.          http://www.redhat.com/