Answer to comments on my previous docs item. First of all, chillout people. This is just the blog of a retired guy. It's not exactly Infoworld, ok?
Sorry if I ruined your day, that was not my goal. I had an idea. Nowadays, being a retired guy, when I have an idea, I either code it for myself or put it in my blog so others can read it. Sometimes it works, sometimes it doesn't.
It was not my goal to say that the writers or editor's job is bad. I meant to say that it can get better, and I had a small idea that may help there.
Rainer: hmmm... well, I translated all of KDE 1.0 (or maybe earlier?) to spanish once, before there was a translations team ;-) but I am sure that doesn't count.
I mentioned in the article that there is no need to write docbook, and that you can send plain text to the docs team. I really really did, so don't ride me about it.
BTW: the docs don't say where to send that plain text email. For example, the kcalc manual says the documentation is copyrighted by Bernd Wuebben and Pamela Roberts (in an obfuscated manner, but that's ok).
I am damn sure that if you send Bernd an email with corrections for kcalc's manual, he won't apply them, because he has been out of KDE development for 5 years. Pamela Roberts I don't know.
So, who exactly is one supposed to send a 20 line explanation of the M-buttons to?
Oh, I get it, you are supposed to figure out that docs.kde.org (which is not mentioned in the manual) has a "Contact us" link... which sends you to http://www.kde.org/documentation/ which then suggests you learn docbook (which is not necessary) and go to http://i18n.kde.org/doc/index-script.php where you are told to contact the app author and email@example.com.
For a 20-line writeup? Does that sound reasonable?
Maybe the template used to generate the docs could be modified to add something in the last page, like "For contributions or corrections to this manual, please send email to firstname.lastname@example.org".
I mean, if that doesn't ruin your day.
But hey, I can see the attitude of Lauri is more open, at least. And yeah, Lauri, thanks for your job, I'm sorry I dropped the app later :-(
Sorting through the really bad garbage is not all that difficult. Would I offer to triage? Sure, if it's made convenient. Make it come as clearly tagged mail with, say, two hyperlinks in it, one for sending to docs team for further review, one for declaring it crap, I can do a hundred of those a day.
Canllaith: I share the feeling about wiki markup. RestructuredText is nice, if you find a wiki that supports it.