[kde-doc-english] Re: On Amarok documentation strategy

[Burkhard Lück]

Am Montag, 27. September 2010, um 08:20:09 schrieb Yuri Chornoivan:
> 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?
> 
From a translators PoV I'd like to have 2). If another chapter of the amarok 
documentation is ready, convert it to docbook.

But let us see what the amarok doc team prefers.
 
-- 
Burkhard Lück