structure for F10 final release notes

Karsten 'quaid' Wade kwade at redhat.com
Fri Sep 26 01:11:35 UTC 2008


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

-- 
Karsten Wade, Community Gardener
Dev Fu : http://developer.redhatmagazine.com
Fedora : http://quaid.fedorapeople.org
gpg key : AD0E0C41
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20080925/daadcd78/attachment.sig>


More information about the fedora-docs-list mailing list