OCT
16
2004

KDE Docs Competition: Announcing the Winners

The Quality Team and Docs Team are pleased to announce the results of the recent Docs Competition. The judges were impressed with a wide range of "very high quality" submissions, all of which can be found here. In time they will all be included in the new User Guide, and each entrant will receive full credit. Read on to find out who won!

The winners were as follows:

  • Adriaan de Groot with an entry on configuring toolbars
  • Nicolas Goutte who wrote about Hand Editing Configuration Files
  • Robert Stoffers whose entry was on Launching Programs

The prizes, kindly donated by O'Reilly, will be in the post soon. Other entrants can expect fame and the gratitude of the KDE community.

The judges also highly commended Richard Moore's entry on Customizing Window Behavior as well as Deepak Sarda's entry on Audio CD Ripping in KDE. The Docs Team would like to extend their thanks to the winners, and to every other entrant, for their excellent work.

Comments

The examples seem to have disappeared from the online version of my text. Anyone wanting to see them can find a copy at:
http://xmelegance.org/customising-window-behaviour/html/customising-wind...


By Richard Moore at Sat, 2004/10/16 - 5:00am

It seems that I'm not able to find my submission...

Andras


By Andras Mantia at Sat, 2004/10/16 - 5:00am

Hi Andras,
Sorry your entry didn't get added to those. I've just added it to the docbook source for that page, and it'll be visible as soon as the HTML is regenerated.


By Philip Rodrigues at Sat, 2004/10/16 - 5:00am

Thanks.


By Andras Mantia at Sat, 2004/10/16 - 5:00am

Am I the only one who thinks having to click on *endless* links and navigate *endless* structure to read documentation is completely unnecessary?

Looking at the UserGuide TNG, I see tons of links. I click on one and what do I get? Many more links... Then I click a link... More links... A tiny piece of text and to get the rest I have to click Next, Next, Next, Next,...

This is really hard work to read.


By KDE User at Sat, 2004/10/16 - 5:00am

Just because the source is docbook, has nothing to do with how much text is on the page, that is simple thing to change. Not everyone agrees with you that pouring everything into one page is a good idea, but it's easily done.

In any case, there wouldn't be a tiny amount of text to read per page, if there were more contents, which was partly the point of the competition, and one which i think succeeded admirably. Each chapter in the competition sample doc, will in fact be either a page, or part of a larger page, when it is merged into the larger document.


By Lauri at Sat, 2004/10/16 - 5:00am

While reading one of winning entries, I wanted to try to flat toolbar mode, but it seems really broken (always appears as the top toolbar, even if it has been set oriented to left, and it doesnt return to flat mode if double clicked again).
Why document it, if doesn't work reliably or even usefully?


By carewolf at Sat, 2004/10/16 - 5:00am

Thanks guys you've all done a great job, it is very easy to understand. Thank you...


By Rizwaan at Sun, 2004/10/17 - 5:00am

"The normal way to send instant messages in KDE is to use the IM client, Kopete."

Hopefully that's going to be rephrased, I don't like the idea of a KDE manual stating that using third party applications is abnormal. :-(


By Rob Kaper at Sun, 2004/10/17 - 5:00am

Two points:

First: Obviously KDE documentation can not cover third party applications, since we have no way to know if they are available. That's always been the case.

Secondly: Obviously, these are the unmodified, as submitted entries, since judging them in any other form would have been really dumb. Of course there is proofreading and some copy-editing to be done.


By Lauri at Sun, 2004/10/17 - 5:00am

I wrote that, so I suppose I should comment.

I suggested the normal way of IM'ing was Kopete because:

I had to say something. suggesting the KDE IM client seemed a better idea than suggesting gaim, for example.

I use kopete, and so felt I could write about it. how many reviews have you seen that were written by people how had used the software for a couple of days? It isn't the same but it is similar.

if you think these reasons suck, then send in a patch.

Pete


By Peter Nuttall at Mon, 2004/10/18 - 5:00am

Mentioning Kopete is just fine with me, I just think it could be rewritten to say something like: "KDE includes a multi-protocol instant messaging application, Kopete". Or something along those lines. It's merely the word 'normal' I don't like. :-)


By Rob Kaper at Mon, 2004/10/18 - 5:00am

It could do with a little massage, that's all. KDE has to remain fairly app-agnostic, because the distributions do customize which applications are available, but tend not to customize the documentation.

"Normal" has implications, as Rob pointed out, that not using Kopete is abnormal, so yes, that sentence needs a rework, but not by much. Pointing out it is the default conveys the message you were trying to get across, without making a value judgement on people who choose not to use it, so everyone is happy.


By Lauri at Mon, 2004/10/18 - 5:00am

how about replacing normal with default? then it would read:

The default way to send instant messages in KDE is to use the IM client, Kopete.

Pete


By Peter Nuttall at Tue, 2004/10/19 - 5:00am

I read in this documents that there is a submenu to switch session, but I do not have this (and I just updated to KDE 3.3.1 yesterday!).
What the hell ?

Thanks.


By Marc at Sun, 2004/10/17 - 5:00am

You must reserve X servers in file "Xservers".


By Anonymous at Sun, 2004/10/17 - 5:00am

OK, I did it.
But now, I have only one console session left :-( and the default session is no more Ctrl+Alt+F7 but Ctrl+Alt+F2. Where can I change this ?


By Marc at Sun, 2004/10/17 - 5:00am

I think the "Launching Applications" entry should mention kicker [buttons].


By Anders at Sun, 2004/10/17 - 5:00am