Content depth/breadth (was: Update of "Docs/Drafts/DesktopUserGuide/Multimedia" by CodyDeHaan])

[Patrick W. Barnes]

On Thursday 06 July 2006 22:29, Karsten Wade <kwade at redhat.com> wrote:
> > The following page has been changed by CodyDeHaan:
> > http://fedoraproject.org/wiki/Docs/Drafts/DesktopUserGuide/Multimedia
> >
> > The comment on the change is:
> > Created. Writers, take a look and give input!
> >
> > New page:
> > = Playing Multimedia (Music & Video) =
> >
> > Fedora Core 5 includes tools for viewing video and listening to audio.
> >
> > 'WRITERS:' What do we do here? Multimedia already exists in the Wiki...
>
> I saw your comment in IRC as well, and I think you are referring to the
> existing content at Docs/Beats/Multimedia, right?

Actually, I believe he is referring to the new Multimedia section of the wiki.

http://fedoraproject.org/wiki/Multimedia

I started this new section with a copy 'n' paste from the Multimedia beat, but 
it contains additional material and several original pages.

>
> The way to think about what is needed is to focus on the purpose of the
> document.  Some of the same material may be covered, but the method is
> going to be different.
>
> The release notes, for example, are a compilation of interesting,
> useful, or crucial facts about a version/release.  If your objective was
> to bake a loaf of bread, the release notes would tell you things such
> as:
>
> * Is the supplied flour white, wheat, or a blend?  Is it all purpose or
> does it need additional gluten?
>
> * Where do you get the water for activating the yeast?
>
> The Desktop User Guide would instead be focused on answering the
> questions:
>
> * The steps for turning flour, water, yeast, and salt into bread.
>
> * How or why different kinds of ovens affect the baking.
>
> * How to modify the recipe if you have a different type of flour.
>
> /me quickly finishes and sends, after letting it sit on his desktop for
> a few days
>

In this case, the information in the Desktop User Guide should probably 
resemble what is currently in the Multimedia beat.  The Multimedia beat needs 
additional details that can best be provided by packagers as the FC6 release 
approaches, and those details will probably not need to go in the Desktop 
User Guide.  Both of the beat and the guide should point to the new 
Multimedia section for further reading, including the more sensitive 
information that the Multimedia section now provides.  The Multimedia section 
will need a lot of further writing, but it already has enough information to 
be useful.

-- 
Patrick "The N-Man" Barnes
nman64 at n-man.com

http://www.n-man.com/

LinkedIn:
http://www.linkedin.com/in/nman64

Have I been helpful?  Rate my assistance!
http://rate.affero.net/nman64/
-- 

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20060707/d0d276f3/attachment.sig>