------- 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.
