On Sun, 2007-12-09 at 14:52 +1300, Vladimir Kosovac wrote:
DUG guidelines have been posted to the list not so long ago by John
Babich, DUG Lead Writer. Here is the relevant excerpt:
########################################################################
As far as the boundary between the DUG and the Administration Guide
(AG), I agree with Paul that the GUI/non-GUI distinction has very
little relevance. We should always point to the GUI apps first, except
in those rare cases where GUI apps don't exist or don't provide the
required functionality.
I think the main distinction is the target audience. The DUG's
audience is the first-time or less-experienced user who wants to
perform common tasks like web-browsing, creating simple spreadsheets
and text documents. The AG's audience is the more-experienced person
who wants to manage a group of users with various access levels, or
set up and administer servers such as HTTP/FTP, IMAP/POP3,
authentication, proxy, DHCP, etc.
########################################################################
John, Paul, Karsten and the rest of doc writers,
I still maintain that the basic parts of a User Manager (Creating users
and groups) have their place in a DUG, though. Users new to Fedora may
also have a need to quickly create multiple accounts on the machine
without having to read the administration guide. Is this still for
discussion or the whole thing will be handled by the admin guide alone?
I think you may be confused on what is a typical use case for a desktop
user. Dekstop users (that is, users who are unfamiliar with an
operating system or Linux) do not need to create multiple accounts on
the machine. The description of the target audience, if memory serves,
is covered in the "Assumptions" section in the DUG. Some folks may
recall me harping many moons ago on the need to accurately describe your
target audience and assumptions when you write a doc, and now you'll see
whence that need arises. Among other purposes, it helps to figure out
what belongs in a given document.
This is definitely a topic for the AG.
--
Paul W. Frields, RHCE
http://paul.frields.org/
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
Fedora Project:
http://pfrields.fedorapeople.org/
irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug