I updated my little pet project on documentating kde's config files If anyone is intreasted it can be found here http://kde-look.org/content/show.php?content=7178
According to a recent thread on kde-devel, Zack Rusin is working on a config file editor for KDE3.2 and some other developers are investigating adding meta info to the files like allowed value range, comments, etc.