[kde-doc-english] On Amarok documentation strategy

Yuri Chornoivan yurchor at ukr.net
Mon Sep 27 08:20:09 CEST 2010


Hi!

For some time there was no any useful documentation to Amarok.

Recently, thanks to some great efforts by Amarok team, we have meaningful  
and clear "Quick Start Guide" on UserBase:

http://userbase.kde.org/Amarok/QuickStartGuide

Regretfully, Amarok manual:

http://userbase.kde.org/Amarok/Manual

is far from finished.

Now, Amarok is at the beginning of the new release cycle and it will be  
useful to elaborate the strategy on documentation landing.

I think that we can proceed as follows:
1) Wait for the Manual to be finished then convert it to the docbook.
    Pros: Documentation will cover all usecases.
    Cons: Due to the huge size it will hardly be translated soon.
2) Use the current converted version  
(http://websvn.kde.org/branches/work/doc/amarok/   : Amarok page + Quick  
Start Guide).
    Pros: Much more time for translation and ironing glitches. Gradual  
landing of documentation.
    Cons: Incomplete documentation.

So, what do you think about this?

Thanks in advance.
Yuri



More information about the kde-doc-english mailing list