First we need someone who has time to review the markup and partices used to document OO stuff in the manual, and then come up with *one true way*, which will be acceptable for the future.
Does anyone have time for this? Unfortunately, I don't.
I think it's important that we get this hashed out sooner than later. The more OO documentation we add without a concrete *one true way*, the more re-doing we'll have to do (which is exponential in the translations).
S
