Some users have requested a complete documentation of the api in the last few month. Some even started writing it in the wiki documentation (3 classes are documented).
Do you have any experience with phpDocumentation? Who would like to document the code? And mark, are you ok with adding more documentation in the code?
I'm a little reluctant to go for this, as it can encourage "undocumentation".
On the other hand, it might be better than what is there now.
But then there is another problem of when you update the code documentation, you will have to merge it with the wiki documentation, which might have been changed independently by some other person...
This is a terrifying prospect - especially when I'm starting to think about a whole new codebase for Vanilla 2. You guys are welcome to do it if you think it is really important, but I don't think I'll take any extra time for it myself.