[kde-doc-english] [Bug 136146] wish -wiki like khelp system

[Jes Hall]

------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
         
http://bugs.kde.org/show_bug.cgi?id=136146         




------- Additional Comments From jhall kde org  2006-10-30 01:45 -------
You do not need to understand anything about how the khelpcenter works to write documentation. I could not tell you the first thing about it and I have contributed thousands of words over the last couple of years.

Write a page on a wiki and email someone the link, write a plain text document and email it to someone, write any format you like and email it, you do not *need* to use CVS or SVN or anything else to contribute. I will not support a system where contributers who have not gone through the process to have SVN accounts can commit documentation without it going through a documentation member. If writing plain text in an email is more than you can be bothered doing then I do not want your contributions - and I know much of the documentation team agrees with me.

The reason this wish has engendered so much heated response is because the wiki suggestion comes up about once a year. Never by a core member of the documentation team, and it's always argued against. This is the 4th time I've argued against it and these days it's gotten tiresome - it's a well known joke at conferences that if you want to rile up a documentation person all you have to do is say 'wiki' near them and they see red and start spluttering =)

I do like the idea of using the current KDE wiki as a 'scratchpad' for documentation. Again though, I will not support any system that would make life so much harder for the documentation team. We need to be able to generate so many different formats in so many different languages, that the only system I could see working better than docbook is latex - and I don't think anyone wants me to suggest we switch to that.