Re: Rookie needs help

["John J. McDonough" <wb8rcr arrl net>]

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