Re: structure for F10 final release notes

On Mon, Sep 29, 2008 at 08:04:52AM -0400, Jason wrote:
> On Thu, 2008-09-25 at 18:11 -0700, Karsten 'quaid' Wade wrote:
> > If you look at the beats, think of them as topic-specific buckets of
> > content:
> > 
> > https://fedoraproject.org/wiki/Docs/Beats
> > 
> > Once converted to XML, we can reorder them at-will to get different
> > structures.  We've discussed doing a radical overhaul in the past, but
> > have instead done a set of slow, steady evolutions. *yawn*
> > 
> > Here is a strawman proposal, meaning a thin structure to throw more
> > ideas against:
> > 
> > https://fedoraproject.org/wiki/Release_notes_structure_for_F10
> > 
> > Trying to cover the usual use cases, give it a tone people might relate
> > to, push up front some issues people care about (installer, bugs,
> > hardware support, etc.)  I believe this structure covers all the Beat
> > content.  To quote:
> > 
> >      1. What's new in Fedora 10 -- Overview
> >      2. What is new for installation and live images -- important
> >         installer notes, live image instruction sets, pointers to more
> >         docs
> >      3. What's the latest on the desktop -- *all* GUI applications,
> >         l10n, a11y 
> >              1. How has software installing and updating improved --
> >                 Add/Remove Software
> >              2. Do you browse the web, read email, and create/edit

Re: structure for F10 final release notes

On Mon, 2008-09-29 at 08:04 -0400, Jason wrote:

> I think this has the sort of grouping/flow most readers like. I would
> like to see us at least try it, see what feedback we get and then
> decide
> yea or nay?

In fact, this is one of the many reasons for having a 'beta' document
ready by F10 Preview Release.  Since it is all translated XML files, we
should be able to tweak the structure from Preview Release responses
without creating a bunch of work for the translators.

- Karsten
-- 
Karsten Wade, Community Gardener
Dev Fu : http://developer.redhatmagazine.com
Fedora : http://quaid.fedorapeople.org
gpg key : AD0E0C41

--

-- 
fedora-docs-list mailing list
fedora-docs-list <at> redhat.com
To unsubscribe: 
https://www.redhat.com/mailman/listinfo/fedora-docs-list

Re: structure for F10 final release notes

On Mon, 2008-09-29 at 09:27 -0400, John J. McDonough wrote:
> ----- Original Message ----- 
> From: "Karsten 'quaid' Wade" <kwade <at> redhat.com>
> To: "Fedora Documentation Project" <fedora-docs-list <at> redhat.com>
> Sent: Thursday, September 25, 2008 9:11 PM
> Subject: structure for F10 final release notes
> 
> [clip]
> >              3. What is to celebrate for musicians, artists, and other
> >                 creative types?
> >              4. What is the new stuff for gamers, scientists, and
> >                 hobbyists?
> 
> This is an interesting breakdown.  I suspect that when technical people 
> think of hobbyists, technical hobbies come to mind, so the grouping with 
> scientists might make sense.  That does, however, leave out non-technical 
> hobbyists.  I have to admit, not being a stamp collector or a quilter, I 
> don't really know that there is anything for non-tech hobbyists, but I 
> suspect there is.  Including the gamers totally confuses me though.  I would 
> think they have more in common with the "creative" types.

Good point, I was using the common to Linux narrow hobbyist definition,
that is, people who play with Linux for personal rather than
professional reasons.  There is also some crossover with power users.

> I'm not sure I can propose a better breakdown, though.  It does seem like 
> there is a big difference between creative and entertainment ... i.e., a 
> music player has a very different audience than a music composition app. 
> The former has more in common with the gamer, in fact, in terms of