Gnome docs update before Beta 2?

[Kyle Nitzsche]

On 04/12/2011 11:56 AM, Matthew East wrote:
> On 12 April 2011 14:31, Jim Campbell<jwcampbell at gmail.com>  wrote:
>> Hi All,
>>
>> On Tue, Apr 12, 2011 at 7:19 AM, Gunnar Hjalmarsson<ubuntu at gunnar.cc>
>> wrote:
>>> On 2011-04-12 13:44, Matthew East wrote:
>>>> On 12 April 2011 12:34, Gunnar Hjalmarsson<ubuntu at gunnar.cc>  wrote:
>>>>> Seeing that the ongoing work is all Unity focused, shouldn't we take
>>>>> into consideration that classic GNOME will be an option also in 11.04?
>>>>> One possible way to do that might be to link to ubuntu-docs - the whole
>>>>> thing or parts of it - with the remark that while parts of the old docs
>>>>> may be dated, they may still be more relevant to classic users.
>>>> This is a clever idea. All we would need to do is to write an index
>>>> page to link to the various documents present in ubuntu-docs and use
>>>> it as our "classic Gnome" help.
>>> It wouldn't be an ideal solution, but considering that we are short of
>>> time...
>>>
>>> Another reason to keep shipping ubuntu-docs is that docs in applications
>>> may be linking to it. I just wrote a document that ended up in
>>> language-selector, and it includes a link to add-applications#installing.
>>>
>>> --
>>> Gunnar Hjalmarsson
>>>
>> ghelp links to both external docbook (<link href="ghelp:about-ubuntu">about
>> Ubuntu</link>) and mallard (<link href="ghelp:banshee">Banshee</link>)
>> documents are working, but there are some issues.
>>
>> For example, I can link to "about-ubuntu", but there doesn't appear to be
>> any way to get back up to the index from there, and I can't seem to find a
>> directory that would contain the "index" of the old Ubuntu-docs package (it
>> might have been in /usr/share/gnome/help/gnome-help/).
> There isn't one. It was hard coded into yelp source code. We would
> need to write a standalone index with its own directory in
> /usr/share/gnome/help if we wanted to have a landing page for "Classic
> Gnome" help using ubuntu-docs.
>

One very good thing to come out of this whole experience is the complete removal 
of help content from yelp (I think/hope this is now the case, starting with 
natty). I reassert my longstanding recommendation that yelp should be pointed at 
the default home page by a gconf key, that all content should be delivered in 
separately. (Previously the Ubuntu Help Center home page was _in_ the yelp 
package.) .

Cheers,
Kyle