4:41 a.m.
In Ubuntu there's a "Help" button on the top menu bar that leads to a
nice help application, yelp. We have that app too, but it doesn't
seem to have the same contents, which are:
New to Ubuntu?
Adding and Removing Software
Files, Folders and Documents
Customising Your Desktop
Internet
Music, Videos and Photos
Assistive Tools
Keeping Your Computer Safe
Printing, Faxing and Scanning
Advanced Topics
And under each section there's a clear explanation of what to do.
Maybe we have something equivalent for Fedora, but I can't find it.
Andrew.
6:10 a.m.
Yelp is basically a document display application. It has the great
advantage of being very bright about localization. We currently display the
release notes and "About Fedora" in yelp.
Unfortunately, yelp is a Gnome application, and the KDE crowd dislikes it.
There is a KDE analog, but it seems to be abused rather than used. There is
so much junk in it that it is impossible to find anything, and what is there
seems to be mostly useless. Much of what you describe in the Ubuntu help is
in the Fedora User's Guide, which will probably be getting a higher profile
now that it is up to date.
Personally, I like yelp and would like to see it used more effectively.
But for the practical reason of trying to be desktop neutral, I would expect
our use of yelp to decline rather than increase.
--McD
----- Original Message -----
From: "Andrew Haley" <aph(a)redhat.com>
To: <fedora-docs-list(a)redhat.com>
Sent: Wednesday, July 08, 2009 5:41 AM
Subject: Help button in Fedora
In Ubuntu there's a "Help" button on the top menu bar
that leads to a
nice help application, yelp. We have that app too, but it doesn't
seem to have the same contents, which are:
New to Ubuntu?
Adding and Removing Software
Files, Folders and Documents
Customising Your Desktop
Internet
Music, Videos and Photos
Assistive Tools
Keeping Your Computer Safe
Printing, Faxing and Scanning
Advanced Topics
And under each section there's a clear explanation of what to do.
Maybe we have something equivalent for Fedora, but I can't find it.
Andrew.
--
fedora-docs-list mailing list
fedora-docs-list(a)redhat.com
To unsubscribe:
https://www.redhat.com/mailman/listinfo/fedora-docs-list
7:49 a.m.
On Wed, 2009-07-08 at 07:10 -0400, John J. McDonough wrote:
Yelp is basically a document display application. It has the great
advantage of being very bright about localization. We currently display the
release notes and "About Fedora" in yelp.
Unfortunately, yelp is a Gnome application, and the KDE crowd dislikes it.
There is a KDE analog, but it seems to be abused rather than used. There is
so much junk in it that it is impossible to find anything, and what is there
seems to be mostly useless. Much of what you describe in the Ubuntu help is
in the Fedora User's Guide, which will probably be getting a higher profile
now that it is up to date.
Personally, I like yelp and would like to see it used more effectively.
But for the practical reason of trying to be desktop neutral, I would expect
our use of yelp to decline rather than increase.
If you ask me, that so called 'desktop neutrality' is exactly what makes
the Fedora offerings in this area so much inferior to Ubuntu.
What Andrew was asking for is to make the Help button show useful
task-oriented documentation. In the default installation, that Help
button brings up Yelp. So, if you want your documents to be found by the
majority of users that need them, this is exactly where they should be:
Behind the help button, in yelp.
6:43 p.m.
On Wed, Jul 08, 2009 at 08:49:18AM -0400, Matthias Clasen wrote:
On Wed, 2009-07-08 at 07:10 -0400, John J. McDonough wrote:
> Yelp is basically a document display application. It has the great
> advantage of being very bright about localization. We currently display the
> release notes and "About Fedora" in yelp.
>
> Unfortunately, yelp is a Gnome application, and the KDE crowd
> dislikes it. There is a KDE analog, but it seems to be abused
> rather than used. There is so much junk in it that it is
> impossible to find anything, and what is there seems to be mostly
> useless. Much of what you describe in the Ubuntu help is in the
> Fedora User's Guide, which will probably be getting a higher
> profile now that it is up to date.
>
> Personally, I like yelp and would like to see it used more
> effectively. But for the practical reason of trying to be desktop
> neutral, I would expect our use of yelp to decline rather than
> increase.
If you ask me, that so called 'desktop neutrality' is exactly what
makes the Fedora offerings in this area so much inferior to Ubuntu.
What Andrew was asking for is to make the Help button show useful
task-oriented documentation. In the default installation, that Help
button brings up Yelp. So, if you want your documents to be found by
the majority of users that need them, this is exactly where they
should be: Behind the help button, in yelp.
How others abuse the khelpcenter shouldn't be our concern, as long as
we're providing clearly available docs there. (I wrote KDE
desktop-specific entries for this in the past release notes that might
be useful to someone at some point.)
My personal opinion is that we should be using Yelp *more* than we do.
If you want to see some cool stuff, look up the GNOME Project Mallard
to see the future of task-based documentation, which (I believe) will
Yelp will be capable of presenting. How can we reconcile those
advances with the use of Publican in Fedora Docs?
http://www.gnome.org/~shaunm/mallard/index.html
--
Paul W. Frields http://paul.frields.org/
gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717
http://redhat.com/ - - - - http://pfrields.fedorapeople.org/
irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug
8:20 a.m.
John J. McDonough wrote:
Yelp is basically a document display application. It has the great
advantage of being very bright about localization. We currently display
the release notes and "About Fedora" in yelp.
Unfortunately, yelp is a Gnome application, and the KDE crowd dislikes
it. There is a KDE analog, but it seems to be abused rather than used.
There is so much junk in it that it is impossible to find anything, and
what is there seems to be mostly useless. Much of what you describe in
the Ubuntu help is in the Fedora User's Guide, which will probably be
getting a higher profile now that it is up to date.
Yeah, but help needs to be there, right behind the Help button. Of course
I don't care whether it's yelp or something else.
Andrew.
5399
days inactive
5399
days old
4 comments
4 participants
participants (4)
-
Andrew Haley -
John J. McDonough -
Matthias Clasen -
Paul W. Frields