I'm on fedora-docs-list, but I'm afraid I can't usually manage to stay current with it. So my apologies for coming back to this discussion late in the game. I am one of the maintainers of Yelp, Gnome's help browser.
It's my understanding that Matthias Clasen has patched Yelp to display some of the Fedora documentation on the front page. There was a lot of talk in threads on this list about how to manage things with upstream.
Currently, we have a situation where at least Ubuntu and Fedora are both patching Yelp in different ways to accomplish the same thing, which rather sucks. Ubuntu did contact me about this, but we were unable to work something out in the time-frame they needed, so they ended up doing their own hack. One reason we had problems is that I wasn't sure how best to make this work for all downstream distributors.
Just as a point of reference, in the future, when there's some question as to how to coordinate things with upstream, you might consider actually contacting the upstream developers.
I know how Ubuntu changed Yelp. And my understanding is that Fedora is just putting General|Linux|Distributions|Other on the front page. I assume this was done by changing scrollkeeper.xml slightly. Could somebody send me the patch? With a clear idea of how both Ubuntu and Fedora have done this, we should be able to produce a better upstream method in 2.14 or 2.16.
// Shaun
On Tue, 2005-11-29 at 13:31 -0600, Shaun McCance wrote:
I'm on fedora-docs-list, but I'm afraid I can't usually manage to stay current with it. So my apologies for coming back to this discussion late in the game. I am one of the maintainers of Yelp, Gnome's help browser.
It's my understanding that Matthias Clasen has patched Yelp to display some of the Fedora documentation on the front page. There was a lot of talk in threads on this list about how to manage things with upstream.
Currently, we have a situation where at least Ubuntu and Fedora are both patching Yelp in different ways to accomplish the same thing, which rather sucks. Ubuntu did contact me about this, but we were unable to work something out in the time-frame they needed, so they ended up doing their own hack. One reason we had problems is that I wasn't sure how best to make this work for all downstream distributors.
Just as a point of reference, in the future, when there's some question as to how to coordinate things with upstream, you might consider actually contacting the upstream developers.
I know how Ubuntu changed Yelp. And my understanding is that Fedora is just putting General|Linux|Distributions|Other on the front page. I assume this was done by changing scrollkeeper.xml slightly. Could somebody send me the patch? With a clear idea of how both Ubuntu and Fedora have done this, we should be able to produce a better upstream method in 2.14 or 2.16.
// Shaun
Shaun, I looked at the Ubuntu patch for inspiration when working on this, and I believe we are doing essentially the same as they do.
I'll attach our patch FYI.
Matthias
On Tue, 2005-11-29 at 14:37 -0500, Matthias Clasen wrote:
On Tue, 2005-11-29 at 13:31 -0600, Shaun McCance wrote:
I know how Ubuntu changed Yelp. And my understanding is that Fedora is just putting General|Linux|Distributions|Other on the front page. I assume this was done by changing scrollkeeper.xml slightly. Could somebody send me the patch? With a clear idea of how both Ubuntu and Fedora have done this, we should be able to produce a better upstream method in 2.14 or 2.16.
// Shaun
Shaun, I looked at the Ubuntu patch for inspiration when working on this, and I believe we are doing essentially the same as they do.
I'll attach our patch FYI.
CCing gnome-doc-devel-list@gnome.org
Ah hah. IIRC, that's exactly what Ubuntu does. The reason I didn't just make G|L|D|Other always top-level is that it seems wrong for those distros that are in ScrollKeeper's (very out-of-date) list. I suppose I could put all of the G|L|D|* categories at the top and just assume most normal people don't have the distro docs for more than one distro installed. But then that screws the BSDs, Solaris, etc.
So currently we have the Other page, which catches all the SK categories under General|* and System|*. What if I put all of System|* in System, put General|Licenses in Licenses, and put everything else under General|* on the front page?
A quick grep on my system (FC4 + some rawhide, no fancy distro docs packages installed) shows the only General|* category used is General|Licenses, and that's only used by the GPL, LGPL, and FDL license texts installed by Gnome.
The ScrollKeeper categories aren't optimal, and we're not going to get a really nice solution until we can replace the help system (and share the new system with KDE, if all goes right). For the time being, though, we can at least manage to share the same dirty hacks.
// Shaun
-
Matthias Clasen -
Shaun McCance