structure for F10 final release notes

Jason jmtaylor90 at gmail.com
Mon Sep 29 12:04:52 UTC 2008


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
>                 office documents?
>              3. What is to celebrate for musicians, artists, and other
>                 creative types?
>              4. What is the new stuff for gamers, scientists, and
>                 hobbyists?
>              5. Power users get what new features and fixes?
>      4. How are things for developers -- devel tools, -devel package
>         changes, i18n
>      5. What do system administrators care about -- services, daemons,
>         non-devel CLI 
>              1. Are there cool new security features - SELinux,
>                 firewall, hashes, new signing key details
>      6. What are the nuts and bolts of hardware support -- arch-specific
>         notes, 
>      7. Are there hideous bugs and terrible tigers? -- known issues,
>         link to up-to-date bug page
>      8. Legal stuff and administrivia
> 
> -- 

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?

-Jason
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 197 bytes
Desc: This is a digitally signed message part
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20080929/cdd92eb4/attachment.sig>


More information about the fedora-docs-list mailing list