The "One" Page Release Notes

[Jonathan Roberts]

> On Tue, Jul 14, 2009 at 02:59:02AM +0530, Rahul Sundaram wrote:
>> On 07/14/2009 02:55 AM, Eric Christensen wrote:
>> > The Docs Team, at the FAD @ SELF, had an idea to create a one-page
>> > Release Notes for users that aren't as technical as some of our other
>> > users.  This Release Notes would be something pretty, graphical, and
>> > would only contain high-level changes.  I guess what we are looking for
>> > is something that is a "composite of the tour and release overview" to
>> > quote Paul (stickster).
>>
>> How is that different from the release summary we used to do before? How
>> do we differentiate this from the more technical detailed release notes?
>

I'm with Rahul here, this is almost exactly the idea of what we used
to aim for with the Release Overview/Summary. There used to be lots of
discussions about how best to create the Release Overview from the
Release Notes without lots of duplication of effort across teams, and
that's why the page Rahul linked looks like a repeated version of the
Release Notes, because at that time we were experimenting with writing
the two on a single page and then dividing the content out for
different audiences.

That didn't work particularly well, and certainly restarting the
Release Overview/Summary with a clearer mission and method is a
worthwhile goal, one I'd like to help with, though it wouldn't hurt to
show a bit more knowledge and recognition of the work people did
before... something that often seems to be lacking a bit in Fedora
land! I've been guilty of this in the past, but I can now appreciate
how trying it is to people who've worked on stuff.

Jon