Instant Messaging Documentation: News Readers need more details

Bug #129189 reported by Dawid van Wyngaard
4
Affects Status Importance Assigned to Milestone
ubuntu-docs (Ubuntu)
Fix Released
Wishlist
Dawid van Wyngaard

Bug Description

Binary package hint: ubuntu-docs

Expand more on the documentation for Internet Messaging: News Readers to include Liferea program and howto setup rss links / feeds in Liferea.

Phil Bull (philbull)
Changed in ubuntu-docs:
importance: Undecided → Wishlist
status: New → Confirmed
Revision history for this message
Dawid van Wyngaard (dawid-i-services) wrote :

I will add Firefox as a newsreader as well....

Changed in ubuntu-docs:
assignee: nobody → dawid-i-services
Changed in ubuntu-docs:
status: Confirmed → In Progress
Revision history for this message
Matthew Paul Thomas (mpt) wrote :

Help on how to set up feeds in Liferea is already present in Liferea's help. If you want to improve Liferea's help, that would be excellent (for example, how to make Firefox's Subscribe button work with Liferea is not at all obvious), but that's nothing to do with ubuntu-docs.

Revision history for this message
Dawid van Wyngaard (dawid-i-services) wrote : Re: [Bug 129189] Re: Instant Messaging Documentation: News Readers need more details

Gents (mdke / mpt),

It's fine with me to take the changes out of the documentation, but
let's consider the following:

Some of the applications in question have online / internet based help,
like Pidgin, which is fine if you have an internet connection to view
the help, but absolutely useless if you don't have access to the net. In
Africa, this is a reality unlike first and second world countries.

I have viewed Ekiga & Liferea's documentation, which is included with
the app, and they are good doc's covering those items we have added to
the Ubuntu docs, but still, Pidgin only has online help, and at that, is
not the best.

Should we then just, as suggested by mdke & mpt:

1) only leave a reference url, and leave those that can't use the online
help in the dark or,
2) Leave the basic procedures for the apps as is and add a reference url
to the apps help as well,
3) Get hold of the Pidgin chaps and ask them to beef up there
documentation / include help documentation with the application.

Interesting one, as I understand the concerns voiced / typed by both mpt
& mdke, but there are those that got a Ubuntu cd somewhere and still
don't have access to the internet...

Thanks,

Dawid

On Wed, 2007-08-01 at 08:13 +0000, Matthew Paul Thomas wrote:

> Help on how to set up feeds in Liferea is already present in Liferea's
> help. If you want to improve Liferea's help, that would be excellent
> (for example, how to make Firefox's Subscribe button work with Liferea
> is not at all obvious), but that's nothing to do with ubuntu-docs.
>

Information about setting up Pidgin should be in the help accessed from
Pidgin's Help menu, which is not part of ubuntu-docs. Information about
setting up an Ekiga account should be in the help accessed from Ekiga's
Help menu, which is not part of ubuntu-docs. And so on. Putting this
information in Ubuntu Help, rather than the program's own help, would
make it unnecessarily difficult to find. (It would also limit its reach
to Ubuntu users, when it would do more good if available to *all* users
of that particular program).

--

Thanks,

Dawid van Wyngaard
Wiki: http://wiki.ubuntu.com/Dawid71
Launchpad: http://launchpad.net/~dawid-i-services/
IRC: raven on network irc.freenode.net
Jabber: dawid@33003.co.za
OpenPGP keys: B25232ED

Revision history for this message
Phil Bull (philbull) wrote :

Hi mpt,

"Help on how to set up feeds in Liferea is already present in Liferea's help. If you want to improve Liferea's help, that would be excellent (for example, how to make Firefox's Subscribe button work with Liferea is not at all obvious), but that's nothing to do with ubuntu-docs."

It has everything to do with ubuntu-docs. Liferea is not installed by default, and when a user searches yelp for 'rss feed', they don't get any results. This is why the Ubuntu docs tell the user what they need to view RSS feeds (Liferea) and what to do to get started. We let the Liferea help take care of anything after that - we're just interested in getting the up and running.

Also, Liferea doesn't ship DocBook help for yelp, as it is GTK only (no GNOME dependency).

Revision history for this message
Matthew Paul Thomas (mpt) wrote :

This is one example of the general question of what Ubuntu Help should cover, so I've raised this on the mailing list. <https://lists.ubuntu.com/archives/ubuntu-doc/2007-August/008990.html>

Revision history for this message
Dawid van Wyngaard (dawid-i-services) wrote :

In this fix:
- Added howto add news feeds and rss feeds for Firfox,
- Added howto for Liferea, adding news feeds to it,
- Added Ekiga Wiki link for more info on Ekiga and some troubleshooting tips.

Changed in ubuntu-docs:
status: In Progress → Fix Committed
Phil Bull (philbull)
Changed in ubuntu-docs:
status: Fix Committed → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.