[PATCH] Allow application to use a website for documentation.

[David Jarvie]

On Monday 25 August 2008 1:07, Aaron J. Seigo wrote:
> On Sunday 24 August 2008, Ingo Klöcker wrote:
>> > this would require some
>> > integration with the help viewer, but wouldn't be rocket science.
>>
>> And that's all that I'm asking for. But I'd prefer to have this solved
>> before the patch is committed. Otherwise we risk nobody implementing it
>> for KDE 4.2. And then we have a problem.
>
> yes, that is why i'm on the fence as well: the whole "once it's in, it's
> in and people have less reason to fix it" syndrome =)

What we need is a fresh look at the documentation/help system for KDE with
the aim of providing an new integrated mechanism. IMO, the biggest need is
to provide context sensitive help so that users don't have to wade through
a big document to find what they need to know (or, as often as not,
discover that the answer isn't there).

A wiki system would be great, provided it is practical for the translators
and can be linked somehow to docbook or whatever might replace that. But
I'm sceptical about adding new unconnected facilities without a clear
strategy for improving the documentation/help system. This may just
encourage the dispersal of information rather than helping to make it more
coordinated and accessible.

-- 
David Jarvie.
KAlarm author & maintainer.
http://www.astrojar.org.uk/kalarm