I don't think that is a bad plan at all for general appeal applications. I
have begun work on some "user guide" types of information for amateur radio
applications. I tend to think that for these more specialized audiences,
the wiki might be a better place. We have a LOT of specialized applications
buried in those 11,000+ packages, and a UG that tried to describe a
significant fraction of them would be unweildy.
I would also like to see more information on how to use the development
applications. Heck, even some sort of categorization could be a big help
there. But again, that doesn't "feel" like it belongs in the UG. Perhaps
there should be a developer's guide (no, I'm not volunteering ;-)
I'm not familiar with clawsmail, but certainly things like xchat-gnome and
konversation seem like good candidates. I think there are about a
half-dozen IRC capable applications, some of them overlap the IM apps, but
it would be nice to see them all described and perhaps compared.
--McD
----- Original Message -----
From: "Matthew Daniels" <danielsmw@xxxxxxxxx>
To: "For participants of the Documentation Project"
<fedora-docs-list@xxxxxxxxxx>
Cc: <fedora-docs-list@xxxxxxxxxx>
Sent: Monday, February 16, 2009 8:57 AM
Subject: Re: Rookie needs help
+1 to updating icons and adding irc clients.
Adding clawsmail is a good thing in my opinion; in the past, it seems
like we've stuck to the defaults for things like communications, but I
see no reason that a well written section on a nondefault application
shouldn't be put in the UG as long as it is maintained. I'd be curious to
hear other opinions on that.
Sorry I didn't get back to you earlier, kirk; everyone should know that
my laptop is in the shop and I'm having some issues getting a loaner, so
most of my computing is via iPod, I.e. Iimited.
-Matthew
Sent from my iPod
On Feb 16, 2009, at 12:12 AM, Kirk <kirk202@xxxxx> wrote:
On Sun, 15 Feb 2009 23:36:46 -0500
David Nalley <david.nalley@xxxxxxxxxxxxxxxxx> wrote:
Hi Kirk
Inline reply follows.
On Sun, Feb 15, 2009 at 6:54 PM, Kirk <kirk202@xxxxx> wrote:
Is there a link to something like a "writer's guide," for us
rookies? I don't know if, or what, we can add to the document
pages. Are we limited to the programs loaded at Fedora's
installation?
We have a style guide.
http://fedoraproject.org/wiki/DocsProject/StyleGuide
That said - it's just about impossible to know what programs are
loaded at installation for any given machine, so the answer is no.
I've been working on the Communications page of the User-Guide for
F10,
https://fedoraproject.org/w/index.php?title=User:Kirk202/User_Guide_-_Communications&action=edit
If someone has the time to look it over and let me know what I need
to change I'd greatly appreciate it. I'd like to start on another
page but would like to know whether or not I'm doing it correctly.
Yesterday I discovered I should have been keeping track of all of
the changes. The biggest changes I made were:
1. Added Claws Mail..should I delete it?
2. Putting the icons at the under the Heading at the
introductory statement without the statement that its the "default
icon for the program." I think I need to change some of the icons
because they are different in the F10 that I'm running vs. those in
the F9 guide that I used as place-holders.
Could be - feel free to do so if appropriate.
3. The TOC was under the introduction (F9) and I can't get it place
anywhere except the top, no matter where I try to put it in the
body of the page. Where's it supposed to be?
Don't worry about that - it will go away when you move to Docbook -
just concentrate on content.
That said you add non-Hx content prior to the Hx and it appears above
the ToC.
Finally, the Communications page doesn't have an IRC program, ie,
X-Chat, or Chatzilla, maybe due to our guidelines?
That's probably an oversight. Since fp.o uses IRC as a main
communications channel we should definitely include IRC in my opinion.
I'd think x-chat for Gnome and konversation for KDE.
Thanks for starting your work with the Docs Project.
David Nalley
Thanks David. This is very helpful. (Hope I'm replying to this
correctly) Appreciate the link to the Style Guide. I'm excited
working with the Docs Project, albeit lots to learn.
I'll work on x-chat & Konversation tomorrow and read the Style Guide as
well.
What's non_Hx content, Hx and fp.o?
Kirk Ziegler
--
fedora-docs-list mailing list
fedora-docs-list@xxxxxxxxxx
To unsubscribe:
https://www.redhat.com/mailman/listinfo/fedora-docs-list
--
fedora-docs-list mailing list
fedora-docs-list@xxxxxxxxxx
To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-docs-list
--
fedora-docs-list mailing list
fedora-docs-list@xxxxxxxxxx
To unsubscribe:
https://www.redhat.com/mailman/listinfo/fedora-docs-list
