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(a)gmail.com>
To: "For participants of the Documentation Project"
<fedora-docs-list(a)redhat.com>
Cc: <fedora-docs-list(a)redhat.com>
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(a)q.com> wrote:
> On Sun, 15 Feb 2009 23:36:46 -0500
> David Nalley <david.nalley(a)fedoraproject.org> wrote:
>
>> Hi Kirk
>>
>> Inline reply follows.
>>
>> On Sun, Feb 15, 2009 at 6:54 PM, Kirk <kirk202(a)q.com> 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_-_Com...
>>>
>>> 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(a)redhat.com
> To unsubscribe:
>
https://www.redhat.com/mailman/listinfo/fedora-docs-list
--
fedora-docs-list mailing list
fedora-docs-list(a)redhat.com
To unsubscribe:
https://www.redhat.com/mailman/listinfo/fedora-docs-list