Amarok Dokumentation issues

[Myriam Schweingruber]

Hi Burkhard,

On Thu, Aug 5, 2010 at 14:44, Burkhard Lück <lueck at hube-lueck.de> wrote:
> Hi,
>
> I found some issues with the  Amarok documentation I'd like to sort out:

> Launching the Help action displays in KHelpcenter the message "There is no
> documentation available for amarok/index.html", bad user experience :-(
>
> The git repo has a folder handbook with a incomplete documentation from
> September 2009, but this handbook is not included in the build and not
> installed.
>
> On Userbase I found page http://userbase.kde.org/Amarok with a documentation
> for Amarok 2.3.
>
> No Handbook menu item in Amaroks Help menu.
>
> Ways to address these issues:
>
> 1) Disable the Help button in the settings dialog, remove X-DocPath entry from
> the desktop file and remove extragear/multimedia/doc/amarok.
>
> or
>
> 2) Add the Handbook menu item again and replace the outdated docbboks from
> 2006 in the svn repo with the userbase page automatically converted to
> docbook. That happens for the k3b documentation already.
> There is no change to your workflow, announce a release as usual on the
> translators mailing list, several doc team members are subscribed there as
> well, so the doc team will then update the svn docbook from the userbase page,
> if necessary.
>
> How to solve these issues?

I think the person who can answer the best about the current state of
the handbook is Valorie, but to me the second solution seems a good
idea.


Regards, Myriam.
-- 
Protect your freedom and join the Fellowship of FSFE:
http://www.fsfe.org
Please don't send me proprietary file formats,
use ISO standard ODF instead (ISO/IEC 26300)