Re: The "One" Page Release Notes
On Tue, Jul 14, 2009 at 03:40, Jonathan Roberts<jonrob(a)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