Rookie needs help

[John J. McDonough]

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