Amarok handbook

[Valorie Zimmerman]

On Sun, Nov 15, 2009 at 11:37 PM, Nikolaj Hald Nielsen
<nhnfreespirit at gmail.com> wrote:
> I will try to answer this.
>
> On Mon, Nov 16, 2009 at 6:55 AM, Valorie Zimmerman
> <valorie.zimmerman at gmail.com> wrote:
>> The Handbook is OLD, and evidently not supported. On the forum, I
>> spoke up and offered to help update the handbook, but I've been
>> looking around, and it looks like the Handbook has been outdated in
>> favor of the wiki at
>
> Yes, the Handbook is OLD. And since it had not been updated for Amarok
> 2 at all, it was removed from within the application as it really amde
> no sense having it there in the current state where it as likely to do
> more harm than good. I dont think the idea for he wiki to supersede it
> though.
>
>> Moving it into another format at some later date will be much simpler,
>> if it's mostly current, correct?

Very likely. I am not a dockbook expert though.

OK. It seems like one or at the most, TWO sources of help should be
linked to. What I'm finding is about 10, all out-of-date. Leaving them
up is no problem, as history, but they should probably all have a note
at the top linking to the current docs.

>> Ugh, googling around before I send this, I see:
>> http://gitorious.org/amarok-handbook which is dated 4 Oct 2009. Is
>> *this* the active project? Author  giofni, * linda.hald.nielsen
>> @gm…l.com
>>
>> And this: http://osdir.com/ml/kde-commits/2009-09/msg06648.html , titled
>> [Amarok] Add first draft of new Amarok Handbook At this poi: msg#06648
>> kde-commits, dated Sat Sep 19 20:18:41 2009 +0200, Author: Linda Hald
>> Nielsen <linda.hald.nielsen at xxxxxxxxx>
>
> I will try to answer for Linda here as she just left for work.
>
> The history goes something like this.
>
> A while back, the amarok team started a google doc in order to get as
> many people as possible to help with a new handbook (I will send you
> an invite to this doc). The thing is, that despite some people putting
> a significant effort into this doc, it currently has no overall
> structure, much of the info is already severely outdated, it contains
> some things that are copied directly from other sources and might not
> even belong in the handbook and most of all it is _huge_. It is my own
> belief that using this document as it is will require more work in
> order to edit it into a sane format than starting over and copying out
> the good parts from this doc one by one.
>
> So Linda decided to try to start from scratch and keep it very simple
> initially with the idea that a small but correct handbook is better
> than a huge one where much of the info is outdated already.
>
> You are more than welcome to help with this. I dont know if if Linda
> has any recent changes lying around uncommitted, but I will make sure
> she commits them if she does.
>
> I hope this answers your questions.
>
> - Nikolaj

Thank you, Nikolaj. That clears up the situation a LOT. I would
appreciate an invite to the Googledoc, and look forward to assisting
Linda with whatever she would like to task me with.

I agree that starting afresh seems like the best idea. There is a lot
of good stuff already written, so taking that -- with permission, of
course -- will speed up things a lot.

More than the Handbook needs updating!

Valorie
-- 
New! http://genealogy-uki.linkpendium.com/
Facebook, Twitter, LinkedIn, Delicious: valoriez .
All my pages: http://valorie.zimmerman.googlepages.com