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.
The examples seem to have disappeared from the online version of my text. Anyone wanting to see them can find a copy at:
It seems that I'm not able to find my submission...
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.
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.
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.
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?
Thanks guys you've all done a great job, it is very easy to understand. Thank you...
"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. :-(
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.
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.
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. :-)
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.
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.
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 ?
You must reserve X servers in file "Xservers".
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 ?
I think the "Launching Applications" entry should mention kicker [buttons].