Documentation of objects

Is there any plan to better document the codebase? Seems lacking in detail and based more on tribal knowledge and understanding of the underlying code base.

I’m surprised – we’ve gotten a lot of compliments about our documentation.
I suppose our sample apps could be better documented.
What do you need to know?