On Thursday 06 July 2006 22:29, Karsten Wade <kwade(a)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(a)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/
--