On Thu, 2007-04-12 at 23:43 +0530, Rahul Sundaram wrote:
Have you considered a person who doesn't know the differences
between
GNOME, KDE and XFCE? When the person comes across such structure it
become mandatory for the person to understand the differences between
these desktop environments and what he/she is running at present before
following the instructions in the guide.
Separate guides for each of the desktop environments can avoid this issue.
By doing this, you move the need to understand the differences between
GNOME, KDE, and XFCE outside of the guide and onto the docs page.
The all-one-guide approach:
"Fedora New User Guide - How to do your common tasks in Fedora, focused
on users who are new to Fedora and/or Linux in general."
The many-guides approach:
"Fedora New GNOME User Guide - How to do your common tasks in Fedora,
focused on users who are new to Fedora and/or Linux in general and who
are using the GNOME desktop environment."
"Fedora New KDE User Guide - How to do your common tasks in Fedora,
focused on users who are new to Fedora and/or Linux in general and who
are using the KDE desktop environment."
"Fedora New XFCE User Guide - How to do your common tasks in Fedora,
focused on users who are new to Fedora and/or Linux in general and who
are using the XFCE desktop environment."
"Note: Fedora offers three choices of desktop environment, with GNOME
being the default. While you can install and run applications from any
desktop environment, you may choose to have the interface specifically
use the engines and tools provided in GNOME, KDE, or XFCE."
OK, then we have to link to what all the new special terms mean ... etc.
Another negative, three separate guides that have X% identical content
and Y% unique content, maintained on a Wiki. In DocBook, it would be
easier. You would have one guide to maintain and three make targets.
If we're not going to teach about the differences between the desktop
environments ... then why write about them in the first place?
- Karsten
--
Karsten Wade, RHCE, 108 Editor ^ Fedora Documentation Project
Sr. Developer Relations Mgr. |
fedoraproject.org/wiki/DocsProject
quaid.108.redhat.com | gpg key: AD0E0C41
////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\