The "One" Page Release Notes

[Eric Christensen]

On Tue, Jul 14, 2009 at 03:40, Jonathan Roberts<jonrob at fedoraproject.org> wrote:
>> 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

Jon,
I don't think we were trying to say that someone wasn't doing their
job in creating this documentation.  We are simply saying that there
may be a better way of doing these projects.  I know that I've been
asked where people can find a document much like I've explained here.

The Docs Project is constantly looking how we can produce the Release
Notes better and that we are getting the information out to our users
in a better way.  This idea is just one of those thoughts.

I know I appreciate everything that everyone does for the Fedora Project.

Eric