Content depth/breadth (was: Update of "Docs/Drafts/DesktopUserGuide/Multimedia" by CodyDeHaan])
Patrick W. Barnes
nman64 at n-man.com
Fri Jul 7 18:58:27 UTC 2006
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.
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
> * 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
> * 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
Patrick "The N-Man" Barnes
nman64 at n-man.com
Have I been helpful? Rate my assistance!
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Size: 189 bytes
Desc: not available
More information about the fedora-docs-list